Função VideoPortGetDeviceData (video.h)
A função VideoPortGetDeviceData recupera informações de configuração detectadas pelo sistema do .. \Machine\Hardware\Description árvore 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 do dispositivo do driver de miniport.
DeviceDataType
Especifica o tipo de dados que está sendo solicitado como um valor de VIDEO_DEVICE_DATA_TYPE, normalmente um dos VpBusData, VpControllerDataou VpMonitorData.
Os valores VpControllerData e VpMonitorData são relevantes apenas em plataformas compatíveis com ARC. Os drivers de miniport de adaptadores de vídeo do tipo x86 geralmente especificam VpBusData, especialmente para adaptadores em ônibus EISA. O valor VpMachineData é reservado para uso futuro.
CallbackRoutine
Ponteiro para uma função de 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 o CallbackRoutine . Normalmente, ele aponta para o buffer de VIDEO_PORT_CONFIG_INFO.
Valor de retorno
VideoPortGetDeviceData retornará NO_ERROR se ele tiver chamado com êxito a função HwVidQueryDeviceCallback do driver de miniporto com informações de configuração.
Observações
VideoPortGetDeviceData não pode ser chamado de funções de HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution.
A árvore de 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 pelo VideoPortGetBusData podem ser mais completas.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |
| biblioteca | Videoprt.lib |
| de DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |