.\" -*- nroff -*- .\" Generated file - DO NOT EDIT! .TH FDICreate 3w "Oct 2012" "Wine API" "Wine API" .SH NAME \fBFDICreate\fR (CABINET.20) .SH SYNOPSIS HFDI FDICreate ( PFNALLOC \fIpfnalloc\fR, PFNFREE \fIpfnfree\fR, PFNOPEN \fIpfnopen\fR, PFNREAD \fIpfnread\fR, PFNWRITE \fIpfnwrite\fR, PFNCLOSE \fIpfnclose\fR, PFNSEEK \fIpfnseek\fR, int \fIcpuType\fR, PERF \fIperf\fR ) .SH DESCRIPTION .PP Provided with several callbacks (all of them are mandatory), returns a handle which can be used to perform operations on cabinet files. .SH PARAMS \fIpfnalloc\fR \fB[In]\fR A pointer to a function which allocates ram. Uses the same interface as malloc. .PP \fIpfnfree\fR \fB[In]\fR A pointer to a function which frees ram. Uses the same interface as free. .PP \fIpfnopen\fR \fB[In]\fR A pointer to a function which opens a file. Uses the same interface as _open. .PP \fIpfnread\fR \fB[In]\fR A pointer to a function which reads from a file into a caller-provided buffer. Uses the same interface as _read. .PP \fIpfnwrite\fR \fB[In]\fR A pointer to a function which writes to a file from a caller-provided buffer. Uses the same interface as _write. .PP \fIpfnclose\fR \fB[In]\fR A pointer to a function which closes a file handle. Uses the same interface as _close. .PP \fIpfnseek\fR \fB[In]\fR A pointer to a function which seeks in a file. Uses the same interface as _lseek. .PP \fIcpuType\fR \fB[In]\fR The type of CPU; ignored in Wine (recommended value: cpuUNKNOWN, aka \fB-1\fR). .PP \fIperf\fR \fB[IO]\fR A pointer to an \fBERF\fR structure. When FDICreate returns an error condition, error information may be found here as well as from GetLastError. .PP .SH RETURNS .PP On success, returns an \fBFDI\fR handle of type \fBHFDI\fR. On failure, the \fBNULL\fR file handle is returned. Error info can be retrieved from \fIperf\fR. .SH INCLUDES .PP fdi.h .SH IMPLEMENTATION .PP Declared in \fB"fdi.h"\fR. .PP Implemented in \fB"dlls/cabinet/fdi.c"\fR. .PP Debug channel \fB"cabinet"\fR.