PVIDEO_HW_POWER_GET fonction de rappel (video.h)
HwVidGetPowerState demande si l’appareil peut prendre en charge l’état d’alimentation demandé.
Syntaxe
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
Paramètres
HwDeviceExtension
Pointeur vers la zone de stockage par adaptateur du pilote miniport. Pour plus d’informations, consultez Extensions d’appareil.
HwId
Pointeur vers un ID d’appareil 32 bits qui identifie de manière unique l’appareil que le pilote miniport doit interroger. Ce paramètre est retourné par la fonction HwVidGetVideoChildDescriptor du pilote miniport. La valeur DISPLAY_ADAPTER_HW_ID indique également que l’adaptateur lui-même demande des informations d’alimentation.
VideoPowerControl
Pointeur vers une structure VIDEO_POWER_MANAGEMENT qui spécifie l’état d’alimentation pour lequel la prise en charge est interrogée.
Valeur retournée
HwVidGetPowerState retourne l’une des valeurs suivantes :
Code de retour | Description |
---|---|
NO_ERROR | L’appareil prend en charge l’état d’alimentation demandé. |
ERROR_DEVICE_REINITIALIZATION_NEEDED | Le pilote a échoué à la requête d’état d’alimentation. |
Remarques
HwVidGetPowerState est une fonction obligatoire dans un pilote de miniport vidéo.
Le pilote doit case activée l’ID spécifié dans HwId pour déterminer l’appareil à interroger. Le pilote doit ensuite déterminer si ce périphérique prend en charge l’état d’alimentation spécifié dans le membre PowerState de la structure VIDEO_POWER_MANAGEMENT vers laquelle videoPowerControl pointe.
Cette fonction ne doit pas retourner l’état d’alimentation actuel de l’appareil.
HwVidGetPowerState doit être rendu paginable.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | video.h (incluez Video.h) |