共用方式為

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（status） 等於 TRUE 的另一個狀態值。 否則，它必須傳回狀態值，NT_SUCCESS（status） 等於 FALSE。

言論

UCX 用戶端驅動程式會呼叫 UcxControllerCreate 方法，向 USB 主機控制器擴充功能 （UCX） 註冊其實作。

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

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1709
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 ucxcontroller.h （include Ucxclass.h）
IRQL PASSIVE_LEVEL

另請參閱

UcxControllerCreate