OID_PM_PROTOCOL_OFFLOAD_LIST
上部のドライバーは、クエリとして、OID_PM_PROTOCOL_OFFLOAD_LIST OID を使用して、基になるネットワーク アダプターに設定されているプロトコル オフロードを列挙できます。 OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、現在アクティブなプロトコル オフロードを記述す NDIS_PM_PROTOCOL_OFFLOAD 構造体の一覧へのポインターが含まれています。
解説
NDIS は、ミニポート ドライバーのクエリを処理します。 NDIS ドライバーは、OID_PM_PROTOCOL_OFFLOAD_LIST OID を使用して、基になるネットワーク アダプターで設定されているプロトコル オフロードの一覧を取得できます。
一覧の各 NDIS_PM_PROTOCOL_OFFLOAD 構造体では、NDIS は、OID 情報バッファーの先頭 (つまり、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーが指すバッファーの先頭) から一覧の次の NDIS_PM_PROTOCOL_OFFLOAD 構造体の先頭まで、NextProtocolOffloadOffset メンバーをオフセットに設定します。 一覧内の最後の構造体の NextProtocolOffloadOffset メンバーのオフセットは 0 です。
ネットワーク アダプターで設定されているプロトコル オフロードがない場合、NDIS は、NDIS_OID_REQUEST の DATA.QUERY_INFORMATION.BytesWritten メンバーを 0 に設定し、NDIS_STATUS_SUCCESS を返します。 DATA.QUERY_INFORMATION.InformationBuffer メンバー内のデータは、NDIS によって変更されません。
NDIS は、この要求に対して次のいずれかの状態コードを返します。
NDIS_STATUS_SUCCESS
要求は正常に完了しました。 InformationBuffer には、プロトコル オフロードの一覧 (存在する場合) へのポインターが含まれています。
NDIS_STATUS_PENDING
要求の完了が保留中です。 最終的な状態コードと結果は、呼び出し元の OID 要求完了ハンドラーに渡されます。
NDIS_STATUS_BUFFER_TOO_SHORT
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_FAILURE
上記の理由以外の理由で要求が失敗しました。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 ミニポート ドライバーには要求されません (「解説」を参照してください)。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |