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 de 32 bits que identifica de forma única el dispositivo que debe consultar el controlador de miniporte. El controlador de miniport devuelve este parámetro función de HwVidGetVideoChildDescriptor. 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 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 energía solicitado.
ERROR_DEVICE_REINITIALIZATION_NEEDED	El controlador produjo un error en la consulta de estado de energía.

Observaciones

HwVidGetPowerState es una función necesaria en un controlador de miniport 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 de PowerState de la estructura de VIDEO_POWER_MANAGEMENT a la que apunta VideoPowerControl.

Esta función no debe devolver el estado de energía actual del dispositivo.

HwVidGetPowerState deben ser paginables.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	video.h (incluya Video.h)

Consulte también

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT