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 di 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.
Commenti
Il driver client UCX registra l'implementazione con l'estensione del controller host USB (UCX) chiamando il metodo UcxControllerCreate .
Questa funzione di callback è facoltativa. Ogni volta che le caratteristiche di trasporto cambiano, il driver client è responsabile della notifica a UCX che una delle caratteristiche è cambiata usando una nuova funzione UcxControllerNotifyTransportCharacteristicsChange.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 1709 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | ucxcontroller.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |