PCAM_CONFIGURE_ROUTINE_EX funzione di callback (usbcamdi.h)

Articolo
08/07/2023

La funzione di callback CamConfigureEx di una fotocamera minidriver configura l'interfaccia di streaming isochronous.

Sintassi

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
)
{...}

Parametri

BusDeviceObject

Puntatore all'oggetto dispositivo del minidriver della fotocamera creato dall'hub USB.

DeviceContext

Puntatore al contesto di dispositivo del minidriver della fotocamera.

Interface

Puntatore alla struttura USBD_INTERFACE_INFORMATION inizializzata con i valori appropriati per una richiesta SELECT_INTERFACE). Questa struttura di interfaccia corrisponde a una singola interfaccia isocrona nel dispositivo.

ConfigurationDescriptor

Puntatore al USB_CONFIGURATION_DESCRIPTOR per questo dispositivo.

PipeConfigListSize

Specifica il numero di elementi nella matrice PipeConfig .

PipeConfig

Puntatore a una matrice di USBCAMD_Pipe_Config_Descriptor che descrive l'associazione tra pipe e flussi.

DeviceDescriptor

Puntatore al USB_DEVICE_DESCRIPTOR per questo dispositivo.

Valore restituito

CamConfigureEx restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

I minidriver della fotocamera usano CamConfigureEx per informare USBCAMD sulla relazione tra pipe individuate e flussi.

USBCAMD chiama la funzione di callback CamConfigureEx per configurare l'interfaccia di streaming isochronous. Al termine della restituzione di questa funzione, USBCAMD può ricevere una notifica dell'interfaccia e dell'impostazione alternativa all'interno dell'interfaccia di streaming video USB da usare per lo stato di inattività.

USBCAMD richiede che la fotocamera abbia una singola descrizione di configurazione USB e tutte le impostazioni alternative all'interno dell'interfaccia di streaming video USB devono avere lo stesso numero e tipo di pipe.

L'USBCAMD originale non chiama CamConfigureEx.

Questa funzione è obbligatoria.