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 |