共用方式為

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 要求給迷你埠驅動程式。
  • 基礎適配卡會發出喚醒事件訊號，例如接收符合網路喚醒模式的封包，或偵測其媒體連線狀態的變更。
NDIS 會呼叫 MiniportCancelIdleNotification來取消閑置通知。 呼叫此處理程式函式時，迷你埠驅動程式會先取消先前針對閑置通知發出的任何總線特定 I/O 要求封包（IRP）。 最後，迷你埠驅動程式會呼叫 NdisMIdleNotificationComplete 來完成閑置通知。

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

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

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
目標平臺 窗戶
標頭 ndis.h （包括 Ndis.h）
IRQL PASSIVE_LEVEL

另請參閱

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete