EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS funzione di callback (ucxcontroller.h)

  • Articolo

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

Vedi anche

UcxControllerCreate