MINIPORT_WDI_IDLE_NOTIFICATION コールバック関数 (dot11wdi.h)
重要
このトピックは、Windows 10でリリースされた WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正のみを受け取ります。 WiFiCx は、Windows 11でリリースされた Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。
NDIS は、ミニポートWdiIdleNotification ハンドラー関数を呼び出して、アイドル状態のネットワーク アダプターで NDIS 選択的中断操作を開始します。 この操作により、ネットワーク アダプターは中断され、低電力状態に移行されます。
これは、 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS内の WDI ミニポート ハンドラーです。
注意
MINIPORT_WDI_IDLE_NOTIFICATION型を使用して関数を宣言する必要があります。 詳細については、次の例に関するセクションを参照してください。
構文
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
パラメーター
[in] MiniportAdapterContext
ミニポート ドライバーが割り当てたコンテキスト領域へのハンドル。
[in] ForceIdle
TRUE に設定すると、ミニポート ドライバーがアイドル状態の通知を拒否し、低電力状態の遷移を続行する必要があることを指定するブール値。
ForceIdle パラメーターの詳細については、「解説」セクションを参照してください。
戻り値
MiniportWdiIdleNotification は、次のいずれかの戻り値を返すことができます。
| リターン コード | 説明 |
|---|---|
| NDIS_STATUS_PENDING | ミニポート ドライバーは、アイドル状態の通知を正常に処理しました。 ミニポート ドライバーが NdisWdiIdleNotificationComplete を呼び出すまで、通知は保留中の状態のままです。 メモ： ミニポート ドライバーは、 ミニポートWdiIdleNotification からNDIS_STATUS_SUCCESSを返す必要があります。 |
| NDIS_STATUS_BUSY | ネットワーク アダプターがまだ使用されているため、ミニポート ドライバーはアイドル状態の通知を拒否しました。 注:ForceIdle パラメーターが TRUE に設定されている場合、MiniportWdiIdleNotification はこの状態コードを返してはなりません。 |
| NDIS_STATUS_FAILURE | ミニポート ドライバーは、バス固有の IRP を正常に発行できませんでした。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| ヘッダー | dot11wdi.h |