PVIDEO_HW_POWER_SET fonction de rappel (video.h)

Article
02/26/2024

HwVidSetPowerState définit l’état d’alimentation de l’appareil spécifié.

Syntaxe

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

VP_STATUS PvideoHwPowerSet(
  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 de périphérique 32 bits qui identifie de manière unique l’appareil pour lequel le pilote miniport doit définir l’état d’alimentation. Ce paramètre est la valeur retournée par la fonction HwVidGetVideoChildDescriptor du pilote miniport. La valeur DISPLAY_ADAPTER_HW_ID indique que le pilote miniport doit définir l’état d’alimentation de l’adaptateur lui-même.

VideoPowerControl

Pointeur vers une structure VIDEO_POWER_MANAGEMENT qui spécifie l’état d’alimentation à définir.

Valeur retournée

HwVidSetPowerState doit toujours retourner NO_ERROR.

Remarques

HwVidSetPowerState 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 le périphérique sur lequel définir l’état d’alimentation. Le pilote doit ensuite définir l’état d’alimentation de ce périphérique au niveau spécifié dans le membre PowerState de la structure VIDEO_POWER_MANAGEMENT vers laquelle VideoPowerControl pointe.

HwVidSetPowerState doit être rendu paginable.