VideoPortQueryServices-Funktion (video.h)
Die VideoPortQueryServices--Funktion macht eine angegebene Schnittstelle verfügbar, die vom Videoporttreiber implementiert wird.
Syntax
VIDEOPORT_API VP_STATUS VideoPortQueryServices(
[in] IN PVOID HwDeviceExtension,
[in] IN VIDEO_PORT_SERVICES ServicesType,
[in, out] IN OUT PINTERFACE Interface
);
Parameter
[in] HwDeviceExtension
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
[in] ServicesType
Ein Wert aus dem aufgezählten Typ VIDEO_PORT_SERVICES, der angibt, welche Schnittstelle angefordert wird.
[in, out] Interface
Zeiger auf eine INTERFACE Struktur, die grundlegende Informationen zur angeforderten Schnittstelle enthält. Weitere Informationen finden Sie in den folgenden Anmerkungen Abschnitt.
Rückgabewert
Wenn VideoPortQueryServices erfolgreich ist, wird NO_ERROR zurückgegeben; andernfalls wird ein Fehlercode zurückgegeben.
Bemerkungen
Wenn der parameter ServicesType auf VideoPortServicesI2C-festgelegt ist, muss der parameter Interface ein Zeiger auf eine VIDEO_PORT_I2C_INTERFACE Struktur sein, als Zeiger in eine INTERFACE-Struktur umwandeln.
Wenn der ServicesType-Parameter auf VideoPortServicesAGP-festgelegt ist, muss der parameter Interface ein Zeiger auf eine VIDEO_PORT_AGP_INTERFACE-Struktur oder eine VIDEO_PORT_AGP_INTERFACE_2-Struktur sein, die jeweils als Zeiger auf eine INTERFACE--Struktur umgestellt wird.
Die VIDEO_PORT_AGP_INTERFACE- und VIDEO_PORT_AGP_INTERFACE_2-Strukturen sind nahezu identisch, mit der Ausnahme, dass die letztere Struktur über ein Element verfügt, das auf die AgpSetRate-Funktion verweist, die zum Zurücksetzen der Übertragungsrate für einen AGP-Chipsatz verwendet wird. Ein Video-Miniporttreiber, der die AGP-Unterstützung abfragt, sollte zuerst VideoPortQueryServices aufrufen, wobei Interface auf eine VIDEO_PORT_AGP_INTERFACE_2 Struktur zeigt. Wenn dieser Aufruf fehlschlägt, kann der Miniporttreiber dann einen weiteren Aufruf an VideoPortQueryServicesdurchführen, diesmal mit Interface, der auf eine VIDEO_PORT_AGP_INTERFACE Struktur zeigt.
Wenn der parameter ServicesType auf VideoPortServicesInt10festgelegt ist, muss der parameter Interface ein Zeiger auf eine VIDEO_PORT_INT10_INTERFACE Struktur sein, die als Zeiger auf eine INTERFACE-Struktur umgestellt wird.
Wenn der parameter ServicesType auf VideoPortServicesDebugReportfestgelegt ist, muss der parameter Interface ein Zeiger auf eine VIDEO_PORT_DEBUG_REPORT_INTERFACE Struktur sein, die als Zeiger auf eine INTERFACE-Struktur umgestellt wird.
Wenn der ServicesType Parameter auf VideoPortServicesWCMemoryProtectionfestgelegt ist, muss der parameter Interface ein Zeiger auf eine VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE Struktur sein, die als Zeiger auf eine INTERFACE-Struktur umgestellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows XP und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |
| Library | Videoprt.lib |
| DLL- | Videoprt.sys |
| IRQL- | PASSIVE_LEVEL |