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
Header |
pm.h |
See Also
Reference
Power Management I/O Controls
POWER_CAPABILITIES
POWER_RELATIONSHIP