PCAM_CONFIGURE_ROUTINE_EX Rückruffunktion (usbcamdi.h)

Artikel
02/29/2024

Die CamConfigureEx-Rückruffunktion eines Kamera-Minitreibers konfiguriert die isochrone Streamingschnittstelle.

Syntax

PCAM_CONFIGURE_ROUTINE_EX PcamConfigureRoutineEx;

NTSTATUS PcamConfigureRoutineEx(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  ULONG PipeConfigListSize,
  PUSBCAMD_Pipe_Config_Descriptor PipeConfig,
  PUSB_DEVICE_DESCRIPTOR DeviceDescriptor
)
{...}

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 die 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 die USB_CONFIGURATION_DESCRIPTOR für dieses Gerät.

PipeConfigListSize

Gibt die Anzahl der Elemente im PipeConfig-Array an.

PipeConfig

Zeiger auf ein USBCAMD_Pipe_Config_Descriptor Array, das die Zuordnung zwischen Pipes und Streams beschreibt.

DeviceDescriptor

Zeiger auf die USB_DEVICE_DESCRIPTOR für dieses Gerät.

Rückgabewert

CamConfigureEx gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.

Hinweise

Kamera-Minidriver verwenden CamConfigureEx , um USBCAMD über die Beziehung zwischen ermittelten Pipes und Streams zu informieren.

USBCAMD ruft die CamConfigureEx-Rückruffunktion 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.

USBCAMD erfordert, dass die Kamera über eine einzelne USB-Konfigurationsbeschreibung verfügen muss, und alle alternativen Einstellungen innerhalb der USB-Videostreamingschnittstelle müssen die gleiche Anzahl und Art von Rohren aufweisen.

Die ursprüngliche USBCAMD ruft CamConfigureEx nicht auf.

Diese Funktion ist erforderlich.