共用方式為

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS回呼函式 (ucxcontroller.h)

  • 發行項

UCX 會叫用此回呼來擷取主機控制器特性。

語法

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

參數

[in] UcxController

用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的UCX控制器句柄。

[out] UcxControllerTransportCharacteristics

主控制器客戶端驅動程式填入傳輸特性 之UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS 結構的指標。

傳回值

如果作業成功，回呼函式必須傳回STATUS_SUCCESS，或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。 否則，它必須傳回狀態值，NT_SUCCESS (状态) 等於 FALSE。

備註

UCX 用戶端驅動程式會藉由呼叫 UcxControllerCreate 方法，向 UCX (UCX) 註冊其實作。

此回呼函式是選擇性的。 每當傳輸特性變更時，用戶端驅動程式會負責通知 UCX，其中一個特性已使用新的 函式 UcxControllerNotifyTransportCharacteristicsChange 來變更。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1709)
最低支援的伺服器 Windows Server 2016
目標平台 Windows
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 ucxcontroller.h (包含 Ucxclass.h)
IRQL PASSIVE_LEVEL

另請參閱

UcxControllerCreate