EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE funzione di callback (udecxusbdevice.h)
L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama questa funzione di callback per modificare la configurazione selezionando un'impostazione alternativa, disabilitando gli endpoint correnti o aggiungendo endpoint dinamici.
Sintassi
EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;
void EvtUdecxUsbDeviceEndpointsConfigure(
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] WDFREQUEST Request,
[in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}
Parametri
[in] UdecxUsbDevice
Handle per l'oggetto dispositivo UDE. Il driver client ha creato questo oggetto in una chiamata precedente a UdecxUsbDeviceCreate.
[in] Request
Handle a un oggetto richiesta framework che rappresenta la richiesta.
[in] Params
Puntatore a una struttura UDECX_ENDPOINTS_CONFIGURE_PARAMS che descrive le opzioni di configurazione.
Valore restituito
nessuno
Osservazioni
Il driver client ha registrato questa funzione di callback in una chiamata precedente a UdecxUsbDeviceInitSetStateChangeCallbacks fornendo un puntatore a funzione alla relativa implementazione.
L'estensione della classe richiama questa funzione di callback per richiedere al driver client di configurare uno o più nuovi endpoint nell'hardware e/o informa il driver quando uno o più endpoint esistenti non vengono più usati.
Dopo aver creato gli endpoint, per ogni nuovo endpoint, il driver client deve chiamare UdecxUsbEndpointSetWdfIoQueue prima di completare la richiesta.
Dopo il rilascio degli endpoint, il driver client non deve usare gli oggetti coda del framework associati agli endpoint. L'estensione della classe considera tali code come eliminate per impedire richieste future.
L'estensione della classe può anche richiedere un nuovo valore di configurazione o un'impostazione alternativa tramite questo callback.
Questa chiamata è asincrona. Il driver client deve segnali il completamento con lo stato completando la richiesta passata dall'estensione della classe.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1.15 |
| Intestazione | udecxusbdevice.h (include Udecx.h) |
| IRQL | <=DISPATCH_LEVEL |