PVIDEO_HW_POWER_SET funzione di callback (video.h)

Articolo
02/29/2024

HwVidSetPowerState imposta lo stato di alimentazione del dispositivo specificato.

Sintassi

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

VP_STATUS PvideoHwPowerSet(
  PVOID HwDeviceExtension,
  ULONG HwId,
  PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per scheda del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.

HwId

Puntatore a un ID dispositivo a 32 bit che identifica in modo univoco il dispositivo per il quale il driver miniport deve impostare lo stato di alimentazione. Questo parametro è il valore restituito dalla funzione HwVidGetVideoChildDescriptor del driver miniport. Un valore di DISPLAY_ADAPTER_HW_ID indica che il driver miniport deve impostare lo stato di alimentazione dell'adattatore stesso.

VideoPowerControl

Puntatore a una struttura VIDEO_POWER_MANAGEMENT che specifica lo stato di alimentazione da impostare.

Valore restituito

HwVidSetPowerState deve sempre restituire NO_ERROR.

Commenti

HwVidSetPowerState è una funzione obbligatoria in un driver miniport video.

Il driver deve controllare l'ID specificato in HwId per determinare il dispositivo in cui impostare lo stato di alimentazione. Il driver deve quindi impostare lo stato di alimentazione del dispositivo sul livello specificato nel membro PowerState della struttura VIDEO_POWER_MANAGEMENT a cui punta VideoPowerControl .

HwVidSetPowerState deve essere reso pageable.