IOCTL_REGISTER_POWER_RELATIONSHIP (Compact 2013)

3/26/2014

This I/O control message notifies the parent device so the parent device can register all devices that it controls. Send this message with DeviceIoControl.

Syntax

BOOL DeviceIoControl(
    HANDLE hDevice,           // handle to device
    DWORD dwIoControlCode,    // use IOCTL_REGISTER_POWER_RELATIONSHIP
    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
  Ignored.

• dwIoControlCode
  [in] Control code for the operation. Use IOCTL_REGISTER_POWER_RELATIONSHIP for this operation.

• lpInBuffer
  [in] Not used; set to NULL.

• nInBufferSize
  [in] Not used; set to zero.

• lpOutBuffer
  [out] Not used; set to NULL.

• nOutBufferSize
  [out] Not used; set to zero.

• lpBytesReturned
  [out] Not used; set to NULL.

Return Values

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

Power Manager ignores the return values from this I/O control, which provides an opportunity for a parent device to notify Power Manager about any active devices that it controls. Power Manager sends this I/O control to devices that include the POWER_CAP_PARENT flag in the Flags member of the POWER_CAPABILITIES structure.

Requirements

See Also

Reference

Power Management I/O Controls
POWER_CAPABILITIES
POWER_RELATIONSHIP