OID_PM_CURRENT_CAPABILITIES
上部の上位ドライバーは、クエリとして、OID_PM_CURRENT_CAPABILITIES OID を使用して、ネットワーク アダプターの現在使用可能な電源管理機能のクエリを実行できます。 OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_PM_CAPABILITIES 構造へのポインターが含まれています。
解説
NDIS は、ミニポート ドライバーのクエリを処理します。 NDIS 6.20 以降では、ミニポート ドライバーは、初期化中に電源管理ハードウェア機能を提供します。 ただし、NDIS は、プロトコル ドライバーからの一部の機能を非表示にできます。 たとえば、ユーザーが電源管理機能の一部またはすべてを無効にすると、NDIS によってさまざまな機能が報告される場合があります。
NDIS がプロトコル ドライバーに報告する現在の電源管理機能は、ミニポート ドライバーが NDIS に報告したハードウェア機能と必ずしも同じではないことに注意してください。
NDIS は、バインド操作中に、NDIS_BIND_PARAMETERS 構造体の PowerManagementCapabilitiesEx メンバーの上部のプロトコル ドライバーに基になるネットワーク アダプターの電源管理機能を報告します。 そのため、プロトコル ドライバーは OID に対するクエリを実行する必要がありません。
NDIS は、NDIS_STATUS_PM_CAPABILITIES_CHANGE 状態表示を発行して、上部のドライバーで使用できる電源管理機能の変更を報告します。
基になるネットワーク アダプターのミニポート ドライバーが NDIS 6.1 以前の場合、NDIS は、基になるネットワーク アダプターの電源管理機能を NDIS_PM_CAPABILITIES NDIS_PM_CAPABILITIES 構造に対して変換します。
NDIS は、この要求に対して次のいずれかの状態コードを返します。
NDIS_STATUS_SUCCESS
要求は正常に完了しました。 InformationBuffer は NDIS_PM_CAPABILITIES 構造体を指します。
NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡すことになります。
NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには要求されません (「解説」を参照してください)。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |