PVIDEO_HW_POWER_GET funzione di callback (video.h)

HwVidGetPowerState esegue una query se il dispositivo può supportare lo stato di alimentazione richiesto.

Sintassi

PVIDEO_HW_POWER_GET PvideoHwPowerGet;

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

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per adattatore 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 che il driver miniport deve eseguire query. Questo parametro viene restituito dalla funzione HwVidGetVideoChildDescriptor del driver miniport. In alternativa, un valore di DISPLAY_ADAPTER_HW_ID indica che le informazioni sull'alimentazione vengono richieste dall'adattatore stesso.

VideoPowerControl

Puntatore a una struttura VIDEO_POWER_MANAGEMENT che specifica lo stato di alimentazione per il quale viene eseguito una query sul supporto.

Valore restituito

HwVidGetPowerState restituisce uno dei valori seguenti:

Codice restituito	Descrizione
NO_ERROR	Il dispositivo supporta lo stato di alimentazione richiesto.
ERROR_DEVICE_REINITIALIZATION_NEEDED	Il driver ha avuto esito negativo nella query sullo stato di alimentazione.

Commenti

HwVidGetPowerState è una funzione necessaria in un driver miniport video.

Il driver deve controllare l'ID specificato in HwId per determinare quale dispositivo eseguire una query. Il driver deve quindi determinare se il dispositivo supporta lo stato di alimentazione specificato nel membro PowerState della struttura VIDEO_POWER_MANAGEMENT a cui Punta VideoPowerControl .

Questa funzione non deve restituire lo stato corrente di alimentazione del dispositivo.

HwVidGetPowerState deve essere reso paginabile.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)

Vedi anche

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT