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

HwVidGetPowerState consulta si el dispositivo puede admitir el estado de energía solicitado.

Sintaxis

PVIDEO_HW_POWER_GET PvideoHwPowerGet;

VP_STATUS PvideoHwPowerGet(
  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 que debe consultar el controlador de miniporte. Este parámetro lo devuelve la función HwVidGetVideoChildDescriptor del controlador de miniport. Como alternativa, un valor de DISPLAY_ADAPTER_HW_ID indica que se solicita información de energía del propio adaptador.

VideoPowerControl

Puntero a una estructura de VIDEO_POWER_MANAGEMENT que especifica el estado de energía para el que se consulta la compatibilidad.

Valor devuelto

HwVidGetPowerState devuelve uno de los siguientes valores:

Código devuelto	Descripción
NO_ERROR	El dispositivo admite el estado de alimentación solicitado.
ERROR_DEVICE_REINITIALIZATION_NEEDED	El controlador produjo un error en la consulta de estado de energía.

Comentarios

HwVidGetPowerState es una función necesaria en un controlador de minipuerto de vídeo.

El controlador debe comprobar el identificador especificado en HwId para determinar qué dispositivo se va a consultar. A continuación, el controlador debe determinar si ese dispositivo admite el estado de alimentación especificado en el miembro PowerState de la estructura de VIDEO_POWER_MANAGEMENT a la que apunta VideoPowerControl .

Esta función no debe devolver el estado de alimentación actual del dispositivo.

HwVidGetPowerState debe ser paginable.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	video.h (incluya Video.h)

Consulte también

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT