共用方式為


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