Share via


IOCTL_CELOG_REPORTZONECHANGE (Compact 2013)

10/16/2014

This I/O control message is used by a CeLog DLL to report that its zones have changed internally without a call to the CeLogSetZones function. Send this message with KernelLibIoControl.

Syntax

BOOL KernelLibIoControl(
    HANDLE hDevice,           // handle to the DLL
    DWORD dwIoControlCode,    // use IOCTL_CELOG_REPORTZONECHANGE
    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_REPORTZONECHANGE for this operation.
  • lpInBuffer
    [in] Set to NULL.
  • nInBufferSize
    [in] Set to zero.
  • 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

A DLL can call this IOCTL whenever it needs to change its zone settings outside the context of a CeLogSetZones API call.

Because this I/O control causes the kernel to call the CeLogGetZones function for every registered CeLog DLL, the DLL that calls IOCTL_CELOG_REPORTZONECHANGE should return its new zone settings when its CeLogQueryZones export is called.

Requirements

Header

pkfuncs.h

See Also

Reference

Tools IOCTLs
IOCTL_CELOG_GETDESKTOPZONE