Freigeben über


PCAM_CONFIGURE_ROUTINE_EX Rückruffunktion (usbcamdi.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile usbcamdi.h (einschließlich Usbcamdi.h)

Weitere Informationen

USBCAMD_DEVICE_DATA2

USBCAMD_Pipe_Config_Descriptor

USBD_INTERFACE_INFORMATION

USB_CONFIGURATION_DESCRIPTOR

USB_DEVICE_DESCRIPTOR