EVT_UDECX_USB_DEVICE_ENDPOINT_ADD funzione di callback (udecxusbdevice.h)

  • Articolo

L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama questa funzione di callback per richiedere al driver client di creare un endpoint dinamico nel dispositivo USB virtuale.

Sintassi

EVT_UDECX_USB_DEVICE_ENDPOINT_ADD EvtUdecxUsbDeviceEndpointAdd;

NTSTATUS EvtUdecxUsbDeviceEndpointAdd(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] PUDECX_USB_ENDPOINT_INIT_AND_METADATA EndpointToCreate
)
{...}

Parametri

[in] UdecxUsbDevice

Handle per l'oggetto dispositivo UDE per il quale il driver client crea un endpoint. Il driver ha creato questo oggetto in una chiamata precedente a UdecxUsbDeviceCreate.

[in] EndpointToCreate

Puntatore a una struttura UDECX_USB_ENDPOINT_INIT_AND_METADATA contenente il descrittore dell'endpoint.

Valore restituito

Se l'operazione ha esito positivo, la funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) equivale a TRUE.

Commenti

Il driver client ha registrato questa funzione di callback in una chiamata precedente a UdecxUsbDeviceInitSetStateChangeCallbacks fornendo un puntatore di funzione alla relativa implementazione.

Nell'implementazione è previsto che il driver client crei l'endpoint chiamando UdecxUsbEndpointCreate usando i parametri di inizializzazione (UDECXUSBENDPOINT_INIT) passati dall'estensione della classe nella struttura UDECX_USB_ENDPOINT_INIT_AND_METADATA .

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 PASSIVE_LEVEL

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

UdecxUsbEndpointCreate

Scrivere un driver client UDE