MINIPORT_CANCEL_IDLE_NOTIFICATION コールバック関数 (ndis.h)

  • [アーティクル]

NDIS は、ミニポート ドライバー に NDIS が中断されたネットワーク アダプターのアクティビティを検出したことを通知するミニポート のハンドラー関数を呼び出します。 このため、NDIS はアイドル状態の通知を取り消して、ネットワーク アダプターを完全な電源状態に切り替えることができます。

構文

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

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

パラメーター

[in] MiniportAdapterContext

ミニポート ドライバーがそのミニポート 初期化Ex 関数で割り当てたコンテキスト領域へのハンドル。 ミニポート ドライバーは、このコンテキスト領域を使用して、ネットワーク アダプターの状態情報を維持します。

戻り値

なし

解説

NDIS 選択的中断インターフェイスをサポートするミニポート ドライバーには、 MiniportCancelIdleNotification ハンドラー関数が必要です。 ドライバーが選択的な中断ハンドラー関数を登録する方法の詳細については、「 NDIS 選択的中断ハンドラー関数の登録」を参照してください。

NDIS は、ミニポート ドライバーの MiniportIdleNotification ハンドラー関数を呼び出して、アイドル状態のネットワーク アダプターで NDIS 選択的中断操作を開始します。 ネットワーク アダプターが中断され、低電力状態に移行した後、NDIS は、次のいずれかの条件に該当する場合、未処理のアイドル通知を取り消すことができます。

  • 基になるプロトコルまたはフィルター ドライバーは、ミニポート ドライバーへの送信パケット要求または OID 要求を発行します。
  • 基になるアダプターは、ウェイクオン LAN (WOL) パターンに一致するパケットを受信したり、メディア接続状態の変化を検出したりするなど、ウェイクアップ イベントを通知します。
NDIS は 、MiniportCancelIdleNotification を呼び出してアイドル状態の通知を取り消します。 このハンドラー関数が呼び出されると、ミニポート ドライバーはまず、アイドル状態の通知に対して以前に発行された可能性があるバス固有の I/O 要求パケット (IRP) を取り消します。 最後に、ミニポート ドライバーは NdisMIdleNotificationComplete を呼び出して、アイドル状態の通知を完了します。

NDIS がアイドル状態の通知を取り消す方法の詳細については、「 NDIS 選択的中断アイドル通知のキャンセル」を参照してください。

MiniportCancelIdleNotification ハンドラー関数と IRP 完了ルーチンを実装する方法のガイドラインについては、「Implementing a MiniportCancelIdleNotification Handler Function」を参照してください。

要件

要件 値
サポートされている最小のクライアント NDIS 6.30 以降でサポートされています。
対象プラットフォーム Windows
ヘッダー ndis.h (Ndis.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete