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) |