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

Weitere Informationen

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2