共用方式為

MINIPORT_CANCEL_IDLE_NOTIFICATION回呼函式 (ndis.h)

  • 發行項

NDIS 會呼叫 MiniportCancelIdleNotification 處理程式函式，通知迷你埠驅動程式 NDIS 已在暫停的網路適配器上偵測到活動。 因此，NDIS 會取消閑置通知，讓網路適配器可以轉換為完整電源狀態。

語法

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

參數

[in] MiniportAdapterContext

迷你埠驅動程式在其 MiniportInitializeEx 函式中配置的內容區域句柄。 迷你埠驅動程式會使用此內容區域來維護網路適配器的狀態資訊。

傳回值

無

備註

支援 NDIS 選擇性暫停介面的迷你埠驅動程式需要 MiniportCancelIdleNotification 處理程式函式。 如需驅動程式如何註冊其選擇性暫停處理程式函式的詳細資訊，請參閱 註冊 NDIS 選擇性暫停處理程式函式。

NDIS 會呼叫迷你埠驅動程式的 MiniportIdleNotification 處理程式函式，以啟動閑置網路適配器上的 NDIS 選擇性暫停作業。 網路適配器暫停並轉換為低電源狀態之後，如果下列任一條件成立，NDIS 可以取消未處理的閑置通知：

  • 過度配置通訊協定或篩選驅動程式會發出傳送封包要求或 OID 要求給迷你埠驅動程式。
  • 基礎配接器會發出喚醒事件的訊號，例如接收符合網路喚醒 (WOL) 模式的封包，或偵測其媒體連線狀態的變更。
NDIS 會呼叫 MiniportCancelIdleNotification 來取消閑置通知。 呼叫此處理程式函式時，迷你埠驅動程式會先取消任何總線特定的 I/O 要求封包， (IRP) 先前可能已針對閑置通知發出。 最後，迷你埠驅動程式會呼叫 NdisMIdleNotificationComplete 來完成閑置通知。

如需 NDIS 如何取消閑置通知的詳細資訊，請參閱 取消 NDIS 選擇性暫停閑置通知。

如需如何實作 MiniportCancelIdleNotification 處理程式函式和 IRP 完成例程的指導方針，請參閱 實作 MiniportCancelIdleNotification 處理程式函式。

規格需求

需求 值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
目標平台 Windows
標頭 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL

另請參閱

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete