MINIPORT_WDI_IDLE_NOTIFICATION回呼函式 (dot11wdi.h)
重要
本主題是 Windows 10 中發行的 WDI 驅動程式模型的一部分。 WDI 驅動程式模型處於維護模式,而且只會收到高優先順序修正。 WiFiCx 是 Windows 11 中發行的 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。
NDIS 會呼叫 MiniportWdiIdleNotification 處理程式函式,在閑置網路適配器上啟動 NDIS 選擇性暫停作業。 透過這項作業,網路適配器會暫停並轉換為低電源狀態。
這是 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS內的 WDI 迷你埠處理程式。
注意
您必須使用 MINIPORT_WDI_IDLE_NOTIFICATION 類型來宣告函式。 如需詳細資訊,請參閱下列範例一節。
語法
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
參數
[in] MiniportAdapterContext
迷你埠驅動程式所配置之內容區域的句柄。
[in] ForceIdle
BOOLEAN 值,當設定為 TRUE 時,指定迷你埠驅動程式不得擁有閑置通知,而且必須繼續低電源狀態轉換。
如需 ForceIdle 參數的詳細資訊,請參閱一節。
傳回值
MiniportWdiIdleNotification 可以傳回下列任何傳回值。
傳回碼 | Description |
---|---|
NDIS_STATUS_PENDING | 迷你埠驅動程式已成功處理閑置通知。 通知會處於擱置狀態,直到迷你埠驅動程式呼叫 NdisWdiIdleNotificationComplete 為止。 注意: 迷你埠驅動程式不得從 MiniportWdiIdleNotification 傳回NDIS_STATUS_SUCCESS。 |
NDIS_STATUS_BUSY | 迷你埠驅動程式已移至閑置通知,因為網路適配器仍在使用中。 注意:如果 ForceIdle 參數設定為 TRUE,MiniportWdiIdleNotification 不得傳回此狀態代碼。 |
NDIS_STATUS_FAILURE | 迷你埠驅動程式無法成功發出總線特定的 IRP。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | dot11wdi.h |