XXX_Open

This function opens a device for reading and/or writing. An application indirectly invokes this function when it calls CreateFile to open special device file names.

Syntax

DWORD XXX_Open( DWORD hDeviceContext DWORD AccessCode DWORD ShareMode );

Parameters

hDeviceContext

Handle to the device context. The XXX_Init function creates and returns this handle.

AccessCode

Specifies the requested access code of the device. The access is a combination of read and write.

ShareMode

Specifies the requested file share mode of the PC Card device. The share mode is a combination of file read and write sharing.

Return Values

This function returns a handle that identifies the open context of the device to the calling application. If your device can be opened multiple times, use this handle to identify each open context. This identifier is passed into the XXX_Read, XXX_Write, XXX_Seek, and XXX_IOControl functions. If the device cannot be opened, this function returns NULL.

Remarks

When this function is called, your device should allocate the resources that it needs for each open context and prepare for operation. This might involve preparing the device for reading or writing and initializing data structures it uses for operation.