NdisMIdleNotificationConfirm 関数 (ndis.h)
ミニポート ドライバー NdisMIdleNotificationConfirm を呼び出して、アイドル状態のネットワーク アダプターを安全に中断し、低電力状態に移行できることを NDIS に通知します。
ミニポート ドライバーは、NDIS 選択的な中断操作中にこの関数を呼び出します。 NDIS は、ドライバーの ミニポートIdleNotification ハンドラー関数を呼び出すときに操作を開始します。
構文
void NdisMIdleNotificationConfirm(
[in] NDIS_HANDLE MiniportAdapterHandle,
[in] NDIS_DEVICE_POWER_STATE IdlePowerState
);
パラメーター
[in] MiniportAdapterHandle
ネットワーク アダプターは、NDIS がミニポートInitializeEx の ミニポートAdapterHandle パラメーターに渡ハンドルします。
[in] IdlePowerState
ネットワーク アダプターが低電力状態遷移に対してサポートする最小の電源状態を指定する NDIS_DEVICE_POWER_STATE 列挙値。
戻り値
何一つ
備考
ミニポート ドライバーは、NDIS がドライバーの ミニポートIdleNotification 関数を呼び出した後、NdisMIdleNotificationConfirm を呼び出します。 NdisMIdleNotificationConfirm を呼び出すことによって、ドライバーは、中断操作を開始し、ネットワーク アダプターを低電力状態に移行できることを NDIS に通知します。 この呼び出しでは、ミニポート ドライバーは、IdlePowerState パラメーターを、デバイスが移行できる最小の電源状態に設定します。
ミニポート ドライバーが NdisMIdleNotificationConfirm 呼び出す前に、ネットワーク アダプターを選択的に中断するために必要なバス固有の I/O 要求パケット (IRP) を発行する必要があります。
たとえば、NDIS が ミニポートIdleNotification 関数を呼び出すと、USB ミニポート ドライバーは、USB アイドル要求 (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) のバス固有の I/O 要求パケット (IRP) を USB バス ドライバーに発行します。 USB バス ドライバーは、ネットワーク アダプターが低電力状態に移行できることを確認すると、IRP に関連付けられているコールバック ルーチンを呼び出します。 コールバック ルーチンのコンテキスト内で、USB ミニポート ドライバーは NdisMIdleNotificationConfirm を呼び出します。 詳細については、「USB アイドル要求 IRP コールバック ルーチンの実装を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.30 以降でサポートされています。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION
NdisMIdleNotificationComplete の