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) |