Função VideoPortGetDeviceData (video.h)

A função VideoPortGetDeviceData recupera informações de configuração detectadas pelo sistema do .. \Machine\Hardware\Description tree no Registro. Essas informações são específicas do barramento ou específicas do adaptador e armazenadas no registro pelo carregador do sistema ou pelo HAL.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

Parâmetros

HwDeviceExtension

Ponteiro para a extensão de dispositivo do driver de miniport.

DeviceDataType

Especifica o tipo de dados que está sendo solicitado como um valor VIDEO_DEVICE_DATA_TYPE, normalmente um de VpBusData, VpControllerData ou VpMonitorData.

Os valores VpControllerData e VpMonitorData são relevantes apenas em plataformas compatíveis com ARC. Drivers de miniporte de adaptadores de vídeo do tipo x86 geralmente especificam VpBusData, especialmente para adaptadores em barramentos EISA. O valor VpMachineData é reservado para uso futuro.

CallbackRoutine

Ponteiro para uma função HwVidQueryDeviceCallback fornecida pelo driver a ser chamada com as informações solicitadas.

Context

Ponteiro para um parâmetro de contexto determinado pelo chamador a ser passado para a CallbackRoutine. Normalmente, ele aponta para o buffer de VIDEO_PORT_CONFIG_INFO .

Retornar valor

VideoPortGetDeviceData retornará NO_ERROR se tiver chamado com êxito a função HwVidQueryDeviceCallback do driver de miniport com informações de configuração.

Comentários

VideoPortGetDeviceData não pode ser chamado das funções HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution.

A árvore do Registro da qual VideoPortGetDeviceData recupera informações de configuração é volátil; ou seja, ele é recriado pelo carregador do sistema ou HAL sempre que o sistema é carregado. Como essas informações são coletadas e armazenadas no início do processo de inicialização, as informações de configuração relativas ao barramento retornadas por VideoPortGetBusData podem ser mais completas.

Requisitos

Confira também

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters