Funzione VideoPortQueryServices (video.h)
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 seguente osservazioni.
Valore restituito
Se VideoPortQueryServices ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore.
Osservazioni
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 a una struttura di 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 quest'ultima struttura ha un membro che punta alla funzione AgpSetRate, che viene usata per reimpostare la velocità di trasferimento per un chipset AGP. Un driver miniport video che esegue query sul supporto AGP deve chiamare VideoPortQueryServices prima con Interface 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 di 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.
Fabbisogno
| 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 |