PCAM_CONFIGURE_ROUTINE Rückruffunktion (usbcamdi.h)

Artikel
02/27/2024

[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.