NdisRetreatNetBufferDataStart 関数 (ndis/nblapi.h)

  • [アーティクル]

NdisRetreatNetBufferDataStart 関数を呼び出して、NET_BUFFER構造体の MDL チェーン内の使用されるデータ空間にアクセスします。

構文

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisRetreatNetBufferDataStart(
  [in]           NET_BUFFER              *NetBuffer,
  [in]           ULONG                   DataOffsetDelta,
  [in]           ULONG                   DataBackFill,
  [in, optional] NET_BUFFER_ALLOCATE_MDL *AllocateMdlHandler
);

パラメーター

[in] NetBuffer

以前に割り当てられたNET_BUFFER構造体へのポインター。

[in] DataOffsetDelta

追加する 使用データ領域 の量。 NDIS は、それに応じて、NET_BUFFER構造体の DataOffset メンバーを調整します。 要求を満たすのに十分な 未使用のデータ領域 がない場合、NDIS は追加のメモリを割り当てます。

[in] DataBackFill

NDIS でメモリを割り当てる必要がある場合、このパラメーターは、割り当てる DataOffsetDelta パラメーターの値に加えて、データ領域の量を指定します。

[in, optional] AllocateMdlHandler

NetAllocateMdl 関数の省略可能なエントリ ポイント。 呼び出し元が NetAllocateMdl 関数のエントリ ポイントを指定する場合、NDIS は NetAllocateMdl を呼び出して MDL とメモリを割り当てます。

戻り値

NdisRetreatNetBufferDataStart は、次のいずれかを返します。

リターン コード 説明
NDIS_STATUS_SUCCESS
 NdisRetreatNetBufferDataStart は、未使用の データ領域 を使用するか、新しいストレージを割り当てることによって、使用 されたデータ領域 が正常に割り当てられます。
NDIS_STATUS_RESOURCES
 リソースが不足しているため、NdisRetreatNetBufferDataStart が失敗しました。
NDIS_STATUS_FAILURE
 リソースが不足している以外の理由で NdisRetreatNetBufferDataStart が失敗しました。

注釈

NdisRetreatNetBufferDataStart は、NET_BUFFER構造体の DataOffset メンバーの値を減らすことで要求を満たそうとします。

未使用のデータ領域が不足している場合、この関数は新しいバッファーと MDL を割り当てて新しいバッファーを記述し、新しい MDL を MDL チェーンの先頭にチェーンします。 NDIS は、AllocateMdl で指定された NetAllocateMdl 関数を呼び出して、MDL とメモリを割り当てます。 NetAllocateMdl 関数は、ドライバーの設計要件を満たす任意の割り当て方法を使用できます。

を呼び出す NdisRetreatNetBufferDataStart で追加された 使用済みデータ領域 を解放する NdisAdvanceNetBufferDataStart 関数。

要件

要件 値
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム ユニバーサル
Header ndis/nblapi.h (ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_NetBuffer_Function(ndis)

こちらもご覧ください

NET_BUFFER

NdisAdvanceNetBufferDataStart

NetAllocateMdl