PCAM_CONFIGURE_ROUTINE Rückruffunktion (usbcamdi.h)
[CamConfigure wird nicht unterstützt und kann in Zukunft geändert oder nicht verfügbar sein. Verwenden Sie stattdessen CamConfigureEx. ]
Die CamConfigure Callbackfunktion eines Kamera-Minidrivers konfiguriert die isochrone Streamingschnittstelle.
Syntax
PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;
NTSTATUS PcamConfigureRoutine(
PDEVICE_OBJECT BusDeviceObject,
PVOID DeviceContext,
PUSBD_INTERFACE_INFORMATION Interface,
PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
PLONG DataPipeIndex,
PLONG SyncPipeIndex
)
{...}
Parameter
BusDeviceObject
Zeiger auf das Geräteobjekt des Kameraminidrivers, das vom USB-Hub erstellt wurde.
DeviceContext
Zeigen Sie auf den Gerätekontext des Kamera-Minidrivers.
Interface
Zeiger auf eine USBD_INTERFACE_INFORMATION Struktur, die mit den richtigen Werten für eine SELECT_INTERFACE URB-Anforderung initialisiert wurde. Diese Schnittstellenstruktur entspricht einer einzelnen isochronen Schnittstelle auf dem Gerät.
ConfigurationDescriptor
Zeiger auf eine initialisierte USB_CONFIGURATION_DESCRIPTOR für dieses Gerät.
DataPipeIndex
Zeigen Sie auf einen Wert, der den Index der Datenpipeline angibt. Der Kamera-Minidriver sollte diesen Wert ausfüllen, bevor er zurückgegeben wird.
SyncPipeIndex
Zeigen Sie auf einen Wert, der den Index der Synchronisierungspipeline angibt, falls erforderlich. Der Kamera-Minidriver sollte diesen Wert ausfüllen, bevor er zurückgegeben wird.
Rückgabewert
CamConfigure gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.
Bemerkungen
Kamera-Minidriver, die die Abwärtskompatibilität mit der ursprünglichen USBCAMD beibehalten müssen, müssen die USBCAMD_DEVICE_DATA Struktur und die zugehörigen Rückruffunktionen verwenden (d. a. Rückruffunktionen, die nicht das Suffix "Ex" enthalten).
USBCAMD ruft die CamConfigure Callbackfunktion des Kameraminidrivers auf, um die isochrone Streamingschnittstelle zu konfigurieren. Nach dem Zurückgeben dieser Funktion kann USBCAMD über welche Schnittstelle und welche alternative Einstellung innerhalb der USB-Videostreamingschnittstelle für den Leerlaufzustand verwendet werden.
Diese Funktion ist erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | usbcamdi.h (include Usbcamdi.h) |