USBCAMD_InitializeNewInterface Funktion (usbcamdi.h)
Die USBCAMD_InitializeNewInterface-Funktion stellt USBCAMD mit allen erforderlichen Informationen bereit, um den Kamera-Minidriver so zu konfigurieren, dass er ordnungsgemäß mit dem Streamklassentreiber 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 einen oder mehrere der folgenden Werte festlegen:
| Flagge | Bedeutung |
|---|---|
| USBCAMD_CamControlFlag_NoVideoRawProcessing | Wenn der Kamera-Minidriver nicht mit Video arbeiten muss, sollte der USBCAMD_CamControlFlag_NoVideoRawProcessing festgelegt werden. Dadurch wird eine Pufferkopie entfernt. |
| USBCAMD_CamControlFlag_NoStillRawProcessing | Wenn der Kamera-Minidriver nicht auf dem rohen Bildframe arbeiten muss, sollte das USBCAMD_CamControlFlag_NoStillRawProcessing Bit festgelegt werden, um eine Pufferkopie zu beseitigen. |
| USBCAMD_CamControlFlag_AssociatedFormat | Das USBCAMD_CamControlFlag_AssociatedFormat Bit sollte festgelegt werden, wenn der Kamera-Minidriver das gleiche Format für Video verwendet wie auf dem virtuellen Noch-Pin. Nachdem dieses Kennzeichen festgelegt wurde, lässt USBCAMD das Öffnen des virtuellen Pins nicht in einem anderen Format als dem Video-Pin zu. Das USBCAMD_CamControlFlag_AssociatedFormat Bit sollte nur festgelegt werden, wenn der virtuelle 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 stille Bildanwendung starten, wenn die Stilltaste auf der Kamera gedrückt wird. USBCAMD sendet ein KSEVENT_VIDCAPTOSTI_EXT_TRIGGER Ereignis, wenn dieses Bit festgelegt ist und die Noch-Taste der Kamera gedrückt wird. |
Rückgabewert
USBCAMD_InitializeNewInterface gibt den Wert USBCAMD_VERSION_200 zurück.
Bemerkungen
Diese Funktion wird nur von USBCAMD Version 2.0 aufgerufen.
Die USBCAMD_InitializeNewInterface-Funktion muss vom Kamera-Minidriver aufgerufen werden, wenn eine SRB_INITIALIZE_DEVICE Anforderung empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | usbcamdi.h (include Usbcamdi.h) |
| Library | Usbcamd2.lib |