Função VideoPortQueryServices (video.h)

Artigo
08/08/2023

A função VideoPortQueryServices expõe uma interface especificada implementada pelo driver de porta de vídeo.

Sintaxe

VIDEOPORT_API VP_STATUS VideoPortQueryServices(
  [in]      IN PVOID               HwDeviceExtension,
  [in]      IN VIDEO_PORT_SERVICES ServicesType,
  [in, out] IN OUT PINTERFACE      Interface
);

Parâmetros

[in] HwDeviceExtension

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

[in] ServicesType

Um valor do VIDEO_PORT_SERVICES tipo enumerado que especifica qual interface está sendo solicitada.

[in, out] Interface

Ponteiro para uma estrutura INTERFACE , que contém informações básicas sobre a interface solicitada. Consulte a seção Comentários a seguir para obter mais informações.

Retornar valor

Se VideoPortQueryServices for bem-sucedido, ele retornará NO_ERROR; caso contrário, ele retornará um código de erro.

Comentários

Se o parâmetro ServicesType estiver definido como VideoPortServicesI2C, o parâmetro Interface deverá ser um ponteiro para uma estrutura VIDEO_PORT_I2C_INTERFACE , convertido como um ponteiro para uma estrutura INTERFACE.

Da mesma forma, se o parâmetro ServicesType for definido como VideoPortServicesAGP, o parâmetro Interface deverá ser um ponteiro para uma estrutura de VIDEO_PORT_AGP_INTERFACE ou uma estrutura VIDEO_PORT_AGP_INTERFACE_2 , cada um convertido como um ponteiro para uma estrutura interface .

As estruturas VIDEO_PORT_AGP_INTERFACE e VIDEO_PORT_AGP_INTERFACE_2 são quase idênticas, exceto que a última estrutura tem um membro que aponta para a função AgpSetRate , que é usada para redefinir a taxa de transferência de um chipset AGP. Um driver de miniporta de vídeo que consulta o suporte à AGP deve chamar VideoPortQueryServices primeiro com Interface apontando para uma estrutura de VIDEO_PORT_AGP_INTERFACE_2. Se essa chamada falhar, o driver de miniporto poderá fazer outra chamada para VideoPortQueryServices, desta vez com Interface apontando para uma estrutura de VIDEO_PORT_AGP_INTERFACE.

Se o parâmetro ServicesType estiver definido como VideoPortServicesInt10, o parâmetro Interface deverá ser um ponteiro para uma estrutura VIDEO_PORT_INT10_INTERFACE , convertido como um ponteiro para uma estrutura INTERFACE.

Se o parâmetro ServicesType estiver definido como VideoPortServicesDebugReport, o parâmetro Interface deverá ser um ponteiro para uma estrutura VIDEO_PORT_DEBUG_REPORT_INTERFACE , convertido como um ponteiro para uma estrutura INTERFACE.

Se o parâmetro ServicesType estiver definido como VideoPortServicesWCMemoryProtection, o parâmetro Interface deverá ser um ponteiro para uma estrutura VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE , convertido como um ponteiro para uma estrutura INTERFACE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	video.h (incluir Video.h)
Biblioteca	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL