VideoPortQueryServices-Funktion (video.h)

Artikel
02/29/2024

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

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] ServicesType

Ein Wert aus dem VIDEO_PORT_SERVICES aufgezählten Typ, 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 im abschnitt "Hinweise ".

Rückgabewert

Wenn VideoPortQueryServices erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein Fehlercode zurückgegeben.

Hinweise

Wenn der ServicesType-Parameter auf VideoPortServicesI2C festgelegt ist, muss der Parameter Interface ein Zeiger auf eine VIDEO_PORT_I2C_INTERFACE-Struktur sein, die als Zeiger auf eine INTERFACE-Struktur umgewandelt wird.

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 umgewandelt wird.

Die VIDEO_PORT_AGP_INTERFACE- und VIDEO_PORT_AGP_INTERFACE_2-Strukturen sind nahezu identisch, mit der Ausnahme, dass die letztere Struktur über einen Member verfügt, der auf die Funktion AgpSetRate 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 verweist. Wenn dieser Aufruf fehlschlägt, kann der Miniporttreiber videoPortQueryServices erneut aufrufen, diesmal mit Interface , das auf eine VIDEO_PORT_AGP_INTERFACE-Struktur verweist.

Wenn der ServicesType-Parameter auf VideoPortServicesInt10 festgelegt ist, muss der Parameter Interface ein Zeiger auf eine VIDEO_PORT_INT10_INTERFACE-Struktur sein, der als Zeiger auf eine INTERFACE-Struktur umgewandelt wird.

Wenn der ServicesType-Parameter auf VideoPortServicesDebugReport festgelegt ist, muss der Parameter Interface ein Zeiger auf eine VIDEO_PORT_DEBUG_REPORT_INTERFACE-Struktur sein, der als Zeiger auf eine INTERFACE-Struktur umgewandelt wird.

Wenn der ServicesType-Parameter auf VideoPortServicesWCMemoryProtection festgelegt ist, muss der Parameter Interface ein Zeiger auf eine VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE-Struktur sein, die als Zeiger auf eine INTERFACE-Struktur umgewandelt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (Video.h einschließen)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL