EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION funzione di callback (ucxcontroller.h)
UCX richiama questa funzione di callback per specificare la preferenza nelle caratteristiche di trasporto per cui il driver client deve inviare notifiche quando si verificano modifiche.
Sintassi
EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;
void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
[in] UCXCONTROLLER UcxController,
[in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}
Parametri
[in] UcxController
Handle per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate.
[in] ChangeNotificationFlags
Opzione bit per bit dei flag che indicano le caratteristiche di trasporto del tipo in cui è interessato UCX. I flag sono definiti in UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS.
Valore restituito
Nessuno
Osservazioni
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.
Il driver client UCX registra l'implementazione con l'estensione del controller host USB chiamando il metodo UcxControllerCreate.
Per un consumo energetico efficiente, UCX richiama questa funzione di callback per specificare le caratteristiche di trasporto a cui è interessato UCX.
È probabile che se il driver client continua a cercare modifiche nelle caratteristiche di trasporto nel controller. Ciò può comportare un consumo elevato di energia e può risultare inefficiente se non sono presenti driver di dispositivo USB registrati per tale notifica di modifica. Per ottimizzare il consumo di energia, UCX richiama questa funzione di callback per informare il driver client se i client sono registrati per le modifiche. Questa funzione di callback passa i flag di notifica delle modifiche come parametro. Se è impostato un flag, indica che è presente almeno un driver di dispositivo registrato. Se il flag non è impostato, significa che non sono presenti client registrati e quindi il controller può ottimizzare la potenza.
Nota
È facoltativo che i driver controller registrino o usino queste funzioni di callback. È valido per un driver controller per richiamare la notifica di modifica anche se UCX ha indicato che non sono presenti client registrati per esso.
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 |