共用方式為


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 可以傳回下列任何傳回值。

傳回碼 描述
NDIS_STATUS_PENDING 迷你埠驅動程式已成功處理閑置通知。 通知會處於擱置狀態,直到迷你埠驅動程式呼叫 NdisWdiIdleNotificationComplete為止。  注意: 迷你埠驅動程式不得從 MiniportWdiIdleNotification傳回NDIS_STATUS_SUCCESS。
NDIS_STATUS_BUSY 迷你埠驅動程式已否決閑置通知,因為網路適配器仍在使用中。 注意:如果 ForceIdle 參數設定 為 TRUEMiniportWdiIdleNotification 不得傳回此狀態代碼。
NDIS_STATUS_FAILURE 迷你埠驅動程式無法成功發出總線特定的 IRP。

要求

要求 價值
最低支援的用戶端 Windows 10
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
標頭 dot11wdi.h

另請參閱

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete