PCAM_CONFIGURE_ROUTINE_EX funzione di callback (usbcamdi.h)
Una minidriver della fotocamera CamConfigureEx funzione di callback configura l'interfaccia di streaming isocrona.
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 del dispositivo del minidriver della fotocamera.
Interface
Puntatore alla struttura USBD_INTERFACE_INFORMATION inizializzata con i valori appropriati per una richiesta SELECT_INTERFACE 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 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.
Osservazioni
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 isocrona. Al termine 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'oggetto USBCAMD originale non chiama CamConfigureEx.
Questa funzione è obbligatoria.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | usbcamdi.h (include Usbcamdi.h) |