OID_PM_GET_PROTOCOL_OFFLOAD
上部のドライバーは、OID_PM_GET_PROTOCOL_OFFLOAD の OID メソッド要求を発行して、ネットワーク アダプターから低電力プロトコル オフロードのパラメーター設定を取得します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、最初は ULONG プロトコル オフロード識別子へのポインターが含まれています。 OID メソッド要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_PM_PROTOCOL_OFFLOAD 構造体へのポインターが含まれています。
解説
NDIS 6.20 以降のプロトコル ドライバーは、OID_PM_GET_PROTOCOL_OFFLOAD メソッド OID を使用して、ネットワーク アダプターから低電力プロトコル オフロードのパラメーター設定を取得します。
情報バッファーは、ULONG 型のプロトコル オフロード識別子を指す必要があります。 NDIS は、NDIS が以前の OID_PM_ADD_PROTOCOL_OFFLOAD OID 要求を基になるネットワーク アダプターに送信したとき、NDIS_PM_PROTOCOL_OFFLOAD 構造体の ProtocolOffloadId メンバーでこのプロトコル オフロード識別子を設定します。
ミニポート ドライバーは、次の要求の状態コードのいずれかを返します。
NDIS_STATUS_SUCCESS
要求されたデータが正常に取得されました。 情報バッファーには、対応する NDIS_PM_PROTOCOL_OFFLOAD 構造体が含まれています。
NDIS_STATUS_PENDING
要求の完了が保留中です。 最終的な状態コードと結果は、呼び出し元の OID 要求完了ハンドラーに渡されます。
NDIS_STATUS_INVALID_PARAMETER
指定されたプロトコル オフロード識別子が無効でした。
NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_NOT_SUPPORTED
ミニポート ドライバーの NDIS バージョンは 6.20 未満です。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには必須です。 (「解説」を参照してください)。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |