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

另請參閱

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete