NdisMIdleNotificationConfirm 関数 (ndis.h)

  • [アーティクル]

ミニポート ドライバーは NdisMIdleNotificationConfirm を呼び出して、アイドル状態のネットワーク アダプターを安全に中断し、低電力状態に移行できることを NDIS に通知します。

ミニポート ドライバーは、NDIS 選択的中断操作中にこの関数を呼び出します。 NDIS は、ドライバーの MiniportIdleNotification ハンドラー関数を呼び出すときに操作を開始します。

構文

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

パラメーター

[in] MiniportAdapterHandle

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

[in] IdlePowerState

ネットワーク アダプターが低電力状態遷移でサポートする最小の電源状態を指定する NDIS_DEVICE_POWER_STATE列挙値 。

メモ USB ネットワーク アダプターの場合、このパラメーターは NdisDeviceStateD2 である必要があります。
 

戻り値

なし

解説

ミニポート ドライバーは、NDIS がドライバーの MiniportIdleNotification 関数を呼び出した後に NdisMIdleNotificationConfirm を呼び出します。 NdisMIdleNotificationConfirm を呼び出すと、ドライバーは、中断操作を開始し、ネットワーク アダプターを低電力状態に移行できることを NDIS に通知します。 この呼び出しでは、ミニポート ドライバーは、デバイスが移行できる最小の電源状態に IdlePowerState パラメーターを設定します。

ミニポート ドライバーが NdisMIdleNotificationConfirm を呼び出す前に、ネットワーク アダプターを選択的に中断するために必要なバス固有の I/O 要求パケット (IRP) を発行する必要があります。

たとえば、NDIS が MiniportIdleNotification 関数を呼び出すと、USB ミニポート ドライバーは、USB バス ドライバーに USB アイドル要求 (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) のバス固有の I/O 要求パケット (IRP) を発行します。 USB バス ドライバーは、ネットワーク アダプターが低電力状態に移行できることを確認すると、IRP に関連付けられているコールバック ルーチンを呼び出します。 コールバック ルーチンのコンテキスト内で、USB ミニポート ドライバーは NdisMIdleNotificationConfirm を呼び出します。 詳細については、「 USB アイドル要求 IRP コールバック ルーチンの実装」を参照してください。

メモ ミニポート ドライバーは、以前に完了したアイドル状態の通知の NdisMIdleNotificationConfirm を呼び出すことはできません。 ミニポート ドライバーは、 NdisMIdleNotificationComplete を呼び出すことによってアイドル状態の通知を完了します。
 
NDIS 選択的中断アイドル通知を処理する方法の詳細については、「 NDIS 選択的中断アイドル通知の処理」を参照してください。

要件

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

こちらもご覧ください

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete