Funzione VideoPortQueryServices (video.h)

Articolo
08/08/2023

La funzione VideoPortQueryServices espone un'interfaccia specificata implementata dal driver della porta video.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] ServicesType

Valore del tipo enumerato VIDEO_PORT_SERVICES che specifica l'interfaccia richiesta.

[in, out] Interface

Puntatore a una struttura INTERFACE , che contiene informazioni di base sull'interfaccia richiesta. Per altre informazioni, vedere la sezione Osservazioni seguenti.

Valore restituito

Se VideoPortQueryServices ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore.

Commenti

Se il parametro ServicesType è impostato su VideoPortServicesI2C, il parametro Interface deve essere un puntatore a una struttura VIDEO_PORT_I2C_INTERFACE , eseguire il cast come puntatore a una struttura INTERFACE.

Analogamente, se il parametro ServicesType è impostato su VideoPortServicesAGP, il parametro Interface deve essere un puntatore a una struttura VIDEO_PORT_AGP_INTERFACE o una struttura VIDEO_PORT_AGP_INTERFACE_2 , ogni cast come puntatore a una struttura INTERFACE .

Le strutture VIDEO_PORT_AGP_INTERFACE e VIDEO_PORT_AGP_INTERFACE_2 sono quasi identiche, ad eccezione del fatto che la seconda struttura ha un membro che punta alla funzione AgpSetRate , utilizzata per reimpostare la velocità di trasferimento per un chipset AGP. Un driver miniport video che esegue query sul supporto AGP deve chiamare prima VideoPortQueryServices con Interfaccia che punta a una struttura VIDEO_PORT_AGP_INTERFACE_2. Se la chiamata ha esito negativo, il driver miniport può quindi effettuare un'altra chiamata a VideoPortQueryServices, questa volta con Interface che punta a una struttura VIDEO_PORT_AGP_INTERFACE.

Se il parametro ServicesType è impostato su VideoPortServicesInt10, il parametro Interface deve essere un puntatore a una struttura VIDEO_PORT_INT10_INTERFACE , eseguire il cast come puntatore a una struttura INTERFACE.

Se il parametro ServicesType è impostato su VideoPortServicesDebugReport, il parametro Interface deve essere un puntatore a una struttura VIDEO_PORT_DEBUG_REPORT_INTERFACE , eseguire il cast come puntatore a una struttura INTERFACE.

Se il parametro ServicesType è impostato su VideoPortServicesWCMemoryProtection, il parametro Interface deve essere un puntatore a una struttura VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE , eseguire il cast come puntatore a una struttura INTERFACE.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL