EVT_UDECX_USB_DEVICE_ENDPOINT_ADD funzione di callback (udecxusbdevice.h)
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 |