IOCTL_CELOG_DEREGISTER (Compact 2013)

10/16/2014

This I/O control message is used by the CeLog DLL to deregister so that it will no longer receive data. Send this message with KernelLibIoControl.

Syntax

BOOL KernelLibIoControl(
    HANDLE hDevice,           // handle to the DLL
    DWORD dwIoControlCode,    // use IOCTL_CELOG_DEREGISTER
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned   // number of bytes returned
);

Parameters

• hDevice
  [in] Handle to the DLL. Must be set to KMOD_CELOG.

• dwIoControlCode
  [in] The control code for the operation. Use IOCTL_CELOG_DEREGISTER for this operation.

• lpInBuffer
  [in] CeLogExportTable_V3 structure that was passed to IOCTL_CELOG_REGISTER.

• nInBufferSize
  [in] Set to sizeof(CeLogExportTable_V3), the size of lpInBuffer.

• lpOutBuffer
  [out] Set to NULL.

• nOutBufferSize
  [out] Set to zero.

• lpBytesReturned
  [out] Set to NULL.

Return Values

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

Even when all handles to the DLL have been closed and the DLL has been deregistered, the DLL will remain loaded in memory. So if other applications load the DLL later, the application will receive a DLL_PROCESS_ATTACH message, and would need to call this I/O control again to become active.

Requirements

Header

pkfuncs.h

See Also

Reference

Tools IOCTLs
IOCTL_CELOG_REGISTER