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 WakeUpFlags メンバーの NDIS_PM_PARAMETERS 構造体の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 は、データを設定します。QUERY_INFORMATION。BytesNeeded 必要な最小バッファー サイズにNDIS_OID_REQUEST構造体のメンバーです。
NDIS_STATUS_INVALID_PARAMETER
基になるネットワーク アダプターがサポートしていない機能を有効にしようとしたため、要求が失敗しました。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
必要条件
バージョン |
NDIS 6.20 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |