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

Artigo
03/01/2024

HwVidSetPowerState define o estado de energia do dispositivo especificado.

Sintaxe

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

VP_STATUS PvideoHwPowerSet(
  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 para o qual o driver de miniporto deve definir o estado de energia. Esse parâmetro é o valor retornado pela função HwVidGetVidVideoChildDescriptor do driver de miniport. Um valor de DISPLAY_ADAPTER_HW_ID indica que o driver de miniporto deve definir o estado de energia do próprio adaptador.

VideoPowerControl

Ponteiro para uma estrutura de VIDEO_POWER_MANAGEMENT que especifica o estado de energia a ser definido.

Retornar valor

HwVidSetPowerState sempre deve retornar NO_ERROR.

Comentários

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

O driver deve marcar a ID especificada em HwId para determinar o dispositivo no qual definir o estado de energia. Em seguida, o driver deve definir o estado de energia desse dispositivo para o nível especificado no membro do PowerState da estrutura VIDEO_POWER_MANAGEMENT à qual o VideoPowerControl aponta.

HwVidSetPowerState deve ser tornado paginável.