共用方式為

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION回呼函式 （ucxcontroller.h）

  • 發行項

UCX 會叫用此回呼函式，以在發生變更時，用戶端驅動程式必須傳送通知的傳輸特性中指定其喜好設定。

語法

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

參數

[in] UcxController

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

[in] ChangeNotificationFlags

旗標的位選項，表示UCX感興趣的類型傳輸特性。 旗標定義於 UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS中。

傳回值

沒有

言論

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

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

為了有效率的耗電量，UCX 會叫用此回呼函式，以指定 UCX 感興趣的傳輸特性。

如果客戶端驅動程序持續尋找控制器中傳輸特性的變更，很可能。 這可能會導致高耗電量，如果沒有針對該變更通知註冊的USB設備驅動器，可能會沒有效率。 為了優化耗電量，UCX 會叫用此回呼函式，讓客戶端驅動程式知道是否已註冊任何用戶端以進行變更。 此回呼函式會將變更通知旗標傳遞為參數。 如果已設定旗標，表示至少有一個裝置驅動程式已註冊。 如果未設定旗標，表示沒有已註冊的用戶端，因此控制器可以優化電源。

注意

控制器驅動程式可以選擇註冊或使用這些回呼函式。 控制器驅動程式可以叫用變更通知，即使 UCX 已指出尚未為其註冊任何用戶端也一樣。

要求

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

另請參閱