USBCAMD_InitializeNewInterface-Funktion (usbcamdi.h)
Die USBCAMD_InitializeNewInterface-Funktion stellt USBCAMD alle erforderlichen Informationen zur Verfügung, um den Kamera-Minidriver so zu konfigurieren, dass er ordnungsgemäß mit dem Stream-Klassentreiber und dem USB-Bustreiber funktioniert.
Syntax
ULONG USBCAMD_InitializeNewInterface(
[in] PVOID DeviceContext,
[in] PVOID DeviceData,
[in] ULONG Version,
[in] ULONG CamControlFlag
);
Parameter
[in] DeviceContext
Zeiger auf gerätespezifischen Kontext.
[in] DeviceData
Zeiger auf eine USBCAMD_DEVICE_DATA2-Struktur .
[in] Version
Gibt die Versionsinformationen an. Dieser Wert sollte auf den Wert USBCAMD_VERSION_200 für die Verwendung mit USBCAMD Version 2.0 festgelegt werden.
[in] CamControlFlag
Gibt an, wie USBCAMD und der Kamera-Minidriver interagieren sollen. Der Kamera-Minidriver sollte diesen Wert auf mindestens einen der folgenden Werte festlegen:
| Flag | Bedeutung |
|---|---|
| USBCAMD_CamControlFlag_NoVideoRawProcessing | Wenn der Kamera-Minidriver nicht auf Video arbeiten muss, sollte er die USBCAMD_CamControlFlag_NoVideoRawProcessing festlegen. Dadurch wird eine Pufferkopie entfernt. |
| USBCAMD_CamControlFlag_NoStillRawProcessing | Wenn der Kamera-Minidriver nicht mit dem rohen Bildrahmen arbeiten muss, sollte das USBCAMD_CamControlFlag_NoStillRawProcessing Bit so festgelegt werden, dass eine Pufferkopie entfernt wird. |
| USBCAMD_CamControlFlag_AssociatedFormat | Das USBCAMD_CamControlFlag_AssociatedFormat Bit sollte festgelegt werden, wenn der Kamera-Minidriver das gleiche Format für Video verwendet wie für die virtuelle Still-Pin. Nachdem dieses Flag festgelegt wurde, lässt USBCAMD nicht zu, dass der virtuelle Standstift in einem anderen Format als der Videopin geöffnet wird. Das USBCAMD_CamControlFlag_AssociatedFormat Bit sollte nur festgelegt werden, wenn die virtuelle Noch-Pin Frames im gleichen Format wie die Videoframes erzeugt. |
| USBCAMD_CamControlFlag_EnableDeviceEvents | Durch festlegen der USBCAMD_CamControlFlag_EnableDeviceEvents wird ein Geräteereignis für den Streamklassentreiber und Microsoft DirectShow verfügbar gemacht. Dadurch kann ein STI-Monitor eine Standbildanwendung starten, wenn die Still-Taste auf der Kamera gedrückt wird. USBCAMD sendet ein KSEVENT_VIDCAPTOSTI_EXT_TRIGGER-Ereignis , wenn dieses Bit festgelegt ist und die Stilltaste der Kamera gedrückt wird. |
Rückgabewert
USBCAMD_InitializeNewInterface gibt den Wert USBCAMD_VERSION_200 zurück.
Hinweise
Diese Funktion wird nur von USBCAMD, Version 2.0 aufgerufen.
Die USBCAMD_InitializeNewInterface-Funktion muss vom Kameraminidriver aufgerufen werden, wenn eine SRB_INITIALIZE_DEVICE-Anforderung empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | usbcamdi.h (einschließlich Usbcamdi.h) |
| Bibliothek | Usbcamd2.lib |