Função VideoPortQueryServices (video.h)

2025-02-07

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 do dispositivo do driver de miniport.

[in] ServicesType

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

[in, out] Interface

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

Valor de retorno

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

Observações

Se o parâmetro ServicesType for definido como VideoPortServicesI2C, o parâmetro interface de 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 VIDEO_PORT_AGP_INTERFACE ou uma estrutura VIDEO_PORT_AGP_INTERFACE_2, cada um convertido como um ponteiro para uma estrutura interface de.

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 miniporto de vídeo que consulta o suporte à AGP deve chamar VideoPortQueryServices primeiro com de Interface de 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 for 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 for definido como VideoPortServicesDebugReport, o parâmetro da 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
de cliente com suporte mínimo	Disponível no Windows XP 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