EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS funzione di callback (ucxcontroller.h)
UCX richiama questo callback per recuperare le caratteristiche del controller host.
Sintassi
EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;
NTSTATUS EvtUcxControllerGetTransportCharacteristics(
[in] UCXCONTROLLER UcxController,
[out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}
Parametri
[in] UcxController
Handle per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate.
[out] UcxControllerTransportCharacteristics
Puntatore a una struttura UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS che il driver client per il controller host riempie con caratteristiche di trasporto.
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(status) è TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(status) è uguale a FALSE.
Osservazioni
Il driver client UCX registra l'implementazione con l'estensione del controller host USB chiamando il metodo UcxControllerCreate.
Questa funzione di callback è facoltativa. Ogni volta che le caratteristiche di trasporto cambiano, il driver client è responsabile di notificare a UCX che una delle caratteristiche è cambiata usando una nuova funzione UcxControllerNotifyTransportCharacteristicsChange.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1709 |
| server minimo supportato | Windows Server 2016 |
| piattaforma di destinazione | Finestre |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | ucxcontroller.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |