PVIDEO_HW_POWER_GET - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// video.h
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
HwVidGetPowerState queries whether the device can support the requested power state.
HwDeviceExtensionPointer to the miniport driver's per-adapter storage area. For more information, see Device Extensions.
HwIdPointer to a 32-bit device ID that uniquely identifies the device that the miniport driver should query. This parameter is returned by the miniport driver's HwVidGetVideoChildDescriptor function. Alternatively, a value of DISPLAY_ADAPTER_HW_ID indicates that power information is being requested of the adapter itself.
VideoPowerControlPointer to a VIDEO_POWER_MANAGEMENT structure that specifies the power state for which support is being queried.
HwVidGetPowerState returns one of the following values:
| Return code | Description |
|---|---|
| NO_ERROR | The device supports the requested power state. |
| ERROR_DEVICE_REINITIALIZATION_NEEDED | The driver failed the power state query. |
HwVidGetPowerState is a required function in a video miniport driver.
The driver should check the ID specified in HwId to determine which device to query. The driver should then determine whether that device supports the power state specified in the PowerState member of the VIDEO_POWER_MANAGEMENT structure to which VideoPowerControl points.
This function must not return the current power state of the device.
HwVidGetPowerState should be made pageable.