PVIDEO_HW_POWER_GET função de retorno de chamada (video.h)

  • Artigo

HwVidGetPowerState consulta 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 Extensões de dispositivo.

HwId

Ponteiro para uma ID de 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 VIDEO_POWER_MANAGEMENT que especifica o estado de energia para o qual o suporte está sendo consultado.

Retornar valor

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.

Comentários

HwVidGetPowerState é uma função necessária em um driver de miniporto de vídeo.

O driver deve marcar 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 para a qual VideoPowerControl aponta.

Essa função não deve retornar o estado de energia atual do dispositivo.

HwVidGetPowerState deve ser tornado paginável.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho video.h (incluir Video.h)

Confira também

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT