次の方法で共有


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

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

構文

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

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

パラメーター

[in] MiniportAdapterContext

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

戻り値

何一つ

備考

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

NDIS は、ミニポート ドライバーの ミニポートIdleNotification ハンドラー関数を呼び出して、アイドル状態のネットワーク アダプターで NDIS 選択的一時停止操作を開始します。 ネットワーク アダプターが中断され、低電力状態に遷移した後、NDIS は、次のいずれかの条件が満たされている場合、未処理のアイドル通知をキャンセルできます。

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

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

ミニポートコールバックIdleNotification ハンドラー関数と IRP 完了ルーチンを実装する方法のガイドラインについては、「ミニポートコールバックIdleNotification ハンドラー関数の実装を参照してください。

必要条件

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

関連項目

IoCancelIrp

ミニポートIdleNotification

NdisMIdleNotificationComplete