Funzione UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Articolo
02/29/2024

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 di tipo UDECX_ENDPOINT_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 collegare il 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 per aggiungere o configurare gli endpoint.

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.

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)
Libreria	Udecxstub.lib
IRQL	PASSIVE_LEVEL