PVIDEO_HW_POWER_GET função de retorno de chamada (video.h)
HwVidGetPowerState consultas se o dispositivo pode dar suporte ao estado de energia solicitado.
Sintaxe
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
Parâmetros
HwDeviceExtension
Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte de Extensões de Dispositivo.
HwId
Ponteiro para uma ID do dispositivo de 32 bits que identifica exclusivamente o dispositivo que o driver de miniporto deve consultar. Esse parâmetro é retornado pela função HwVidGetVideoChildDescriptor do driver de miniport. Como alternativa, um valor de DISPLAY_ADAPTER_HW_ID indica que as informações de energia estão sendo solicitadas do próprio adaptador.
VideoPowerControl
Ponteiro para uma estrutura de VIDEO_POWER_MANAGEMENT que especifica o estado de energia para o qual o suporte está sendo consultado.
Valor de retorno
HwVidGetPowerState retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| NO_ERROR | O dispositivo dá suporte ao estado de energia solicitado. |
| ERROR_DEVICE_REINITIALIZATION_NEEDED | O driver falhou na consulta de estado de energia. |
Observações
HwVidGetPowerState é uma função necessária em um driver de miniporto de vídeo.
O driver deve verificar a ID especificada em HwId para determinar qual dispositivo consultar. Em seguida, o driver deve determinar se esse dispositivo dá suporte ao estado de energia especificado no membro PowerState da estrutura VIDEO_POWER_MANAGEMENT à qual pontos de VideoPowerControl.
Essa função não deve retornar o estado de energia atual do dispositivo.
HwVidGetPowerState deve ficar paginável.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |