PCAM_CONFIGURE_ROUTINE funzione di callback (usbcamdi.h)

Articolo
02/29/2024

[CamConfigure non è supportato e potrebbe essere modificato o non disponibile in futuro. Usare invece CamConfigureEx. ]

La funzione di callback CamConfigure di un minidriver della fotocamera configura l'interfaccia di streaming isocrona.

Sintassi

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

NTSTATUS PcamConfigureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  PLONG DataPipeIndex,
  PLONG SyncPipeIndex
)
{...}

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 a una 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 a un USB_CONFIGURATION_DESCRIPTOR inizializzato per questo dispositivo.

DataPipeIndex

Puntatore a un valore che indica l'indice della pipe dei dati. Il minidriver della fotocamera deve compilare questo valore prima di restituire.

SyncPipeIndex

Puntatore a un valore che indica l'indice della pipe di sincronizzazione, se necessario. Il minidriver della fotocamera deve compilare questo valore prima di restituire.

Valore restituito

CamConfigure restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

I minidriver della fotocamera che devono mantenere la compatibilità con le versioni precedenti con USBCAMD originale devono usare la struttura USBCAMD_DEVICE_DATA e le funzioni di callback associate, ovvero le funzioni di callback che non contengono il suffisso "Ex").

USBCAMD chiama la funzione di callback CamConfigure del minidriver della fotocamera per configurare l'interfaccia di streaming isocrona. 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à.

Questa funzione è obbligatoria.