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 に設定されている場合、ミニポートWdiIdleNotification はこの状態コードを返してはなりません。
NDIS_STATUS_FAILURE	ミニポート ドライバーは、バス固有の IRP を正常に発行できませんでした。

必要条件

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

関連項目

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete