OID_PM_REMOVE_PROTOCOL_OFFLOAD
NDIS およびプロトコル ドライバーは、セット要求として、OID_PM_REMOVE_PROTOCOL_OFFLOAD OID を使用して、ネットワーク アダプターから電源管理プロトコル オフロードを削除します。 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、最初は ULONG プロトコル オフロード識別子へのポインターが含まれています。
解説
NDIS およびプロトコル ドライバーは、OID_PM_REMOVE_PROTOCOL_OFFLOAD OID を使用して、基になるネットワーク アダプターからプロトコル オフロードを削除します。
NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.InformationBuffer メンバーは、以前に追加されたプロトコル オフロード識別子の ULONG 値を指す必要があります。 NDIS は、NDIS が以前の OID_PM_ADD_PROTOCOL_OFFLOAD OID 要求を基になるネットワーク アダプターに送信したとき、NDIS_PM_PROTOCOL_OFFLOAD 構造体の ProtocolOffloadId メンバーでこのプロトコル オフロード識別子を設定します。
ミニポート ドライバー ライターの解説
NDIS では確実に、バッファー サイズが少なくとも sizeof(ULONG) で、有効なプロトコル オフロード ID が含まれています。 したがって、ミニポート ドライバーの MiniportOidRequest 関数は、この要求の NDIS_STATUS_SUCCESS を返す必要があります。
注 ミニポート ドライバーがリセットされている場合、その MiniportOidRequest 関数は NDIS_STATUS_NOT_ACCEPTED を返す必要があります。
状態コードを返す
NDIS は、この要求に対して次のいずれかの状態コードを返します。
NDIS_STATUS_SUCCESS
プロトコル オフロードが正常に削除されました。
NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡すことになります。
NDIS_STATUS_INVALID_LENGTH
情報バッファーが小さすぎます。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズ (バイト単位) を設定します。
NDIS_STATUS_FILE_NOT_FOUND
OID 要求のプロトコル オフロード識別子が無効です。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには必須です。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |