PVIDEO_HW_POWER_SET función de devolución de llamada (video.h)

Artículo
02/26/2024

HwVidSetPowerState establece el estado de alimentación del dispositivo especificado.

Sintaxis

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

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

Parámetros

HwDeviceExtension

Puntero al área de almacenamiento por adaptador del controlador de miniporte. Para obtener más información, consulte Extensiones de dispositivo.

HwId

Puntero a un identificador de dispositivo de 32 bits que identifica de forma única el dispositivo para el que el controlador de minipuerto debe establecer el estado de alimentación. Este parámetro es el valor devuelto por la función HwVidGetVideoChildDescriptor del controlador de miniport. Un valor de DISPLAY_ADAPTER_HW_ID indica que el controlador de minipuerto debe establecer el estado de alimentación del propio adaptador.

VideoPowerControl

Puntero a una estructura de VIDEO_POWER_MANAGEMENT que especifica el estado de energía que se va a establecer.

Valor devuelto

HwVidSetPowerState siempre debe devolver NO_ERROR.

Comentarios

HwVidSetPowerState es una función necesaria en un controlador de miniporte de vídeo.

El controlador debe comprobar el identificador especificado en HwId para determinar el dispositivo en el que se va a establecer el estado de alimentación. A continuación, el controlador debe establecer el estado de energía del dispositivo en el nivel especificado en el miembro PowerState de la estructura VIDEO_POWER_MANAGEMENT a la que apunta VideoPowerControl .

HwVidSetPowerState debe ser paginable.