Condividi tramite


Funzione UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Indica il tipo di endpoint (semplice o dinamico) nei parametri di inizializzazione usati dal driver client per creare il dispositivo USB virtuale.

Sintassi

VOID UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Parametri

[in, out] UdecxUsbDeviceInit

Puntatore a una struttura allocata da WDF che contiene parametri di inizializzazione per il dispositivo USB virtuale. Il driver client ha recuperato questo puntatore nella chiamata precedente a UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Valore UDECX_ENDPOINT_TYPE-type che indica il tipo di endpoint USB.

Valore restituito

Nessuno

Osservazioni

Prima di creare il dispositivo USB virtuale, il driver client deve indicare il tipo di endpoint supportato. Può supportare uno dei due tipi (definiti in UDECX_ENDPOINT_TYPE):

  • Endpoint semplice: il driver client crea tutti gli oggetti endpoint prima di collegarsi al dispositivo. Il dispositivo deve avere una sola configurazione e un'impostazione di interfaccia per ogni interfaccia.
  • Endpoint dinamico: il client crea oggetti endpoint nella funzione di callback EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE. L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama l'implementazione del driver quando ottiene una richiesta di aggiungere o configurare gli endpoint.
Il UdecxUsbDeviceInit è una struttura opaca che contiene puntatori alle funzioni di callback correlate agli endpoint. Se il driver client supporta endpoint dinamici, queste funzioni di callback devono essere implementate dal driver: Prima di chiamare questo metodo, il driver client deve avere impostato tali puntatori chiamando UdecxUsbDeviceInitSetStateChangeCallbacks.

Fabbisogno

Requisito Valore
client minimo supportato Windows 10
server minimo supportato Windows Server 2016
piattaforma di destinazione Finestre
versione minima di KMDF 1.15
intestazione udecxusbdevice.h (include Udecx.h)
libreria Udecxstub.lib
IRQL PASSIVE_LEVEL

Vedere anche

architettura : UDE (USB Device Emulation)

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE

endpoint USB

UdecxUsbDeviceInitAllocate

UdecxUsbDeviceInitSetStateChangeCallbacks

Scrivere un driver client UDE