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 al 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 dei tipi in cui UCX è interessato. 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(stato) equivale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE.

Il driver client UCX registra l'implementazione con l'estensione del controller host USB (UCX) chiamando il metodo UcxControllerCreate .

Per un consumo efficiente di energia, UCX richiama questa funzione di callback per specificare le caratteristiche di trasporto in cui UCX è interessato.

È 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ò essere 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 consentire al driver client di sapere se i client vengono registrati per le modifiche. Questa funzione di callback passa i flag di notifica delle modifiche come parametro. Se viene impostato un flag, indica che è registrato almeno un driver di dispositivo. Se il flag non è impostato, significa che non sono presenti client registrati e quindi il controller può ottimizzare l'alimentazione.

Requisiti

Vedi anche

• UcxControllerCreate