EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE funzione di callback (udecxusbdevice.h)

  • Articolo

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

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

UdecxUsbEndpointSetWdfIoQueue

Scrivere un driver client UDE