FDICreate function (fdi.h)

The FDICreate function creates an FDI context.

Syntax

HFDI DIAMONDAPI FDICreate(
  [in]      PFNALLOC pfnalloc,
  [in]      PFNFREE  pfnfree,
  [in]      PFNOPEN  pfnopen,
  [in]      PFNREAD  pfnread,
  [in]      PFNWRITE pfnwrite,
  [in]      PFNCLOSE pfnclose,
  [in]      PFNSEEK  pfnseek,
  [in]      int      cpuType,
  [in, out] PERF     perf
);

Parameters

[in] pfnalloc

Pointer to an application-defined callback function to allocate memory. The function should be declared using the FNALLOC macro.

[in] pfnfree

Pointer to an application-defined callback function to free previously allocated memory. The function should be declared using the FNFREE macro.

[in] pfnopen

Pointer to an application-defined callback function to open a file. The function should be declared using the FNOPEN macro.

[in] pfnread

Pointer to an application-defined callback function to read data from a file. The function should be declared using the FNREAD macro.

[in] pfnwrite

Pointer to an application-defined callback function to write data to a file. The function should be declared using the FNWRITE macro.

[in] pfnclose

Pointer to an application-defined callback function to close a file. The function should be declared using the FNCLOSE macro.

[in] pfnseek

Pointer to an application-defined callback function to move a file pointer to the specified location. The function should be declared using the FNSEEK macro.

[in] cpuType

In the 16-bit version of FDI, specifies the CPU type and can be any of the following values.

[in, out] perf

Pointer to an ERF structure that receives the error information.

Return value

If the function succeeds, it returns a non-NULL HFDI context pointer; otherwise, it returns NULL.

Extended error information is provided in the ERF structure.

Requirements

See also

FDIDestroy