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 がアイドル状態の通知を取り消す方法の詳細については、「 NDIS 選択的中断アイドル通知のキャンセル」を参照してください。
MiniportCancelIdleNotification ハンドラー関数と IRP 完了ルーチンを実装する方法のガイドラインについては、「Implementing a MiniportCancelIdleNotification Handler Function」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.30 以降でサポートされています。 |
| 対象プラットフォーム | Windows |
| ヘッダー | ndis.h (Ndis.h を含む) |
| IRQL | PASSIVE_LEVEL |
こちらもご覧ください