OID_PM_PARAMETERS

プロトコル ドライバーは、クエリとして、OID_PM_PARAMETERS OID を使用して、現在有効になっているネットワーク アダプターの電源管理ハードウェア機能に対するクエリを実行できます。 OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_PM_PARAMETERS 構造へのポインターが含まれています。

プロトコル ドライバーは、セットとして、OID_PM_PARAMETERS OID を使用して、ネットワーク アダプターの現在のハードウェア機能を有効または無効にできます。 プロトコル ドライバーは、NDIS_OID_REQUEST 構造体の InformationBuffer メンバー内の NDIS_PM_PARAMETERS 構造体へのポインターを提供します。

解説

NDIS 6.20 以降では、上部のプロトコルとフィルター ドライバーは、OID_PM_PARAMETERS を使用して、現在有効になっているネットワーク アダプターの電源管理ハードウェア機能に対してクエリを実行し、設定します。

上部のドライバーが OID_PM_PARAMETERS OID に対してクエリを実行すると、NDIS はミニポート ドライバーに転送せずに要求を完了します。 NDIS は、要求された設定を格納し、他のこのような要求からの設定と組み合わせます。 NDIS は、ネットワーク アダプターを低電力状態に移行する前に、NDIS によって格納されたすべての要求の組み合わされた設定を含むセット要求をミニポート ドライバーに送信します。

現在有効になっている機能は、ハードウェアがサポートする機能のサブセットとなる場合があります。 ハードウェアがサポートする機能の詳細については、「OID_PM_HARDWARE_CAPABILITIES」を参照してください。

注 NDIS は、NDIS_PM_PARAMETERS 構造体の WakeUpFlags メンバーで NDIS_PM_SELECTIVE_SUSPEND_ENABLED フラグを設定する場合、ミニポート ドライバーに直接 OID_PM_PARAMETERS の OID セット要求を発行します。 これにより、NDIS は、ネットワーク ドライバー スタックのフィルター ドライバーによる処理をバイパスできます。

NDIS またはミニポート ドライバーは、次の要求の状態コードのいずれかを返します。

NDIS_STATUS_SUCCESS
要求は正常に完了しました。

NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡すことになります。

NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。

NDIS_STATUS_INVALID_PARAMETER
この要求は、下位ネットワークアダプターがサポートしていない機能を有効にしようとしたため、失敗しました。

NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。

要件

バージョン	NDIS 6.20 以降でサポートされています。
ヘッダー	Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES