PCAM_CONFIGURE_ROUTINE Rückruffunktion (usbcamdi.h)
[CamConfigure wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen CamConfigureEx. ]
Die CamConfigure-Rückruffunktion 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 Kamera-Minitreibers, das vom USB-Hub erstellt wurde.
DeviceContext
Zeiger auf den Gerätekontext des Kamera-Minitreibers.
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
Zeiger auf einen Wert, der den Index der Datenpipe angibt. Der Kamera-Minidriver sollte diesen Wert ausfüllen, bevor er zurückgegeben wird.
SyncPipeIndex
Zeiger auf einen Wert, der den Index der Synchronisierungspipe 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.
Hinweise
Kamera-Minidriver, die Abwärtskompatibilität mit dem ursprünglichen USBCAMD aufrechterhalten müssen, müssen die USBCAMD_DEVICE_DATA-Struktur und die zugehörigen Rückruffunktionen (d. a. Rückruffunktionen, die nicht das Suffix "Ex" enthalten) verwenden.
USBCAMD ruft die Rückruffunktion CamConfigure der Kamera minidriver auf, um die isochrone Streamingschnittstelle zu konfigurieren. Nachdem diese Funktion zurückgegeben wurde, kann USBCAMD benachrichtigt werden, welche Schnittstelle und welche alternative Einstellung innerhalb der USB-Videostreamingschnittstelle für den Leerlaufzustand verwendet werden soll.
Diese Funktion ist erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | usbcamdi.h (einschließlich Usbcamdi.h) |