MINIPORT_WDI_IDLE_NOTIFICATIONコールバック関数 (dot11wdi.h)

重要

このトピックは、Windows 10 でリリース WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。 WiFiCx は、Windows 11 でリリースされた Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。

NDIS は、アイドル状態のネットワーク アダプターで NDIS 選択的中断操作を開始するミニポートWdiIdleNotification ハンドラー関数を呼び出します。 この操作により、ネットワーク アダプターは中断され、低電力状態に遷移します。

これは、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 パラメーターの詳細については、「解説」セクションを参照してください。

戻り値

ミニポートWdiIdleNotification は、次の戻り値のいずれかを返すことができます。

リターン コード 形容
NDIS_STATUS_PENDING ミニポート ドライバーは、アイドル状態の通知を正常に処理しました。 ミニポート ドライバーが NdisWdiIdleNotificationComplete 呼び出すまで、通知は保留中の状態のままです。  注: ミニポート ドライバーは、ミニポートWdiIdleNotification からNDIS_STATUS_SUCCESS返す必要があります。
NDIS_STATUS_BUSY ミニポート ドライバーは、ネットワーク アダプターがまだ使用されているため、アイドル状態の通知を拒否しました。 注:ForceIdle パラメーターが TRUE に設定されている場合、この状態コード返すことはできません。
NDIS_STATUS_FAILURE ミニポート ドライバーは、バス固有の IRP を正常に発行できませんでした。

必要条件

要件 価値
サポートされる最小クライアント Windows 10
サポートされる最小サーバー Windows Server 2016
ターゲット プラットフォーム ウィンドウズ
ヘッダー dot11wdi.h

関連項目

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete