PVIDEO_HW_POWER_GET fonction de rappel (video.h)

  • Article

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)

Voir aussi

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT