NdisMIdleNotificationComplete 関数 (ndis.h)

  • [アーティクル]

ミニポート ドライバーは NdisMIdleNotificationComplete を呼び出して、NDIS 選択的中断操作の保留中のアイドル通知を完了します。 NDIS は、ドライバーの MiniportIdleNotification ハンドラー関数を呼び出すときに操作を開始します。

構文

void NdisMIdleNotificationComplete(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

パラメーター

[in] MiniportAdapterHandle

NDIS が MiniportInitializeExの MiniportAdapterHandle パラメーターに渡したネットワーク アダプター ハンドル。

戻り値

なし

解説

NDIS は、ミニポート ドライバーの MiniportCancelIdleNotification ハンドラー関数を呼び出して、NDIS 選択的中断操作の保留中のアイドル通知を完了します。 ミニポート ドライバーは NdisMIdleNotificationComplete を呼び出して、ネットワーク アダプターのアイドル状態の通知が完了したことを NDIS に通知します。 NDIS は、選択的な中断操作を完了するために、アダプターを完全な電源状態に切り替えます。

ミニポート ドライバーが NdisMIdleNotificationComplete を呼び出す前に、アイドル状態の通知に対して以前に発行したバス固有の I/O 要求パケット (IRP) を取り消す必要があります。

たとえば、NDIS が MiniportIdleNotification 関数を呼び出すと、USB ミニポート ドライバーはバス固有の USB アイドル要求 IRP (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) を USB バス ドライバーに発行します。 NDIS がドライバーの MiniportCancelIdleNotification 関数を呼び出すと、ドライバーは IRP を取り消します。 USB バス ドライバーは、IRP に関連付けられている完了ルーチンを呼び出すと、IRP が取り消され、デバイスが完全な電源状態に再開できることを確認します。 完了ルーチンのコンテキストでは、ミニポート ドライバーは NdisMIdleNotificationComplete を呼び出します。 詳細については、「 USB アイドル要求 IRP 完了ルーチンの実装」を参照してください。

ミニポート ドライバーが NDIS 選択的中断アイドル通知を完了する方法の詳細については、「 NDIS 選択的中断アイドル通知の完了」を参照してください。

メモ ミニポート ドライバーは、以前に完了したアイドル状態の通知の NdisMIdleNotificationConfirm を呼び出す必要があります。
 

要件

要件 値
サポートされている最小のクライアント NDIS 6.30 以降でサポートされています。
対象プラットフォーム ユニバーサル
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportCancelIdleNotification

MiniportIdleNotification

NdisMIdleNotificationConfirm