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

こちらもご覧ください

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete