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

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

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

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

注意

控制器驅動程式可以選擇註冊或使用這些回呼函式。 即使UCX已指出沒有任何客戶端已註冊變更通知，控制器驅動程序還是可以叫用變更通知。

規格需求

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

另請參閱

• UcxControllerCreate