NdisRetreatNetBufferListDataStart 関数 (ndis/nblapi.h)

  • [アーティクル]

NdisRetreatNetBufferListDataStart 関数を呼び出して、NET_BUFFER_LIST構造体内のすべてのNET_BUFFER構造体で使用されるデータ領域を増やします。

構文

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisRetreatNetBufferListDataStart(
  [in]           NET_BUFFER_LIST         *NetBufferList,
  [in]           ULONG                   DataOffsetDelta,
  [in]           ULONG                   DataBackFill,
  [in, optional] NET_BUFFER_ALLOCATE_MDL *AllocateMdlHandler,
  [in, optional] NET_BUFFER_FREE_MDL     *FreeMdlHandler
);

パラメーター

[in] NetBufferList

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

[in] DataOffsetDelta

各NET_BUFFER構造体に 追加で使用されるデータ領域 の量。 要求を満たすのに十分な 未使用のデータ領域 がない場合、NDIS はより多くのメモリを割り当てます。

[in] DataBackFill

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

[in, optional] AllocateMdlHandler

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

[in, optional] FreeMdlHandler

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

戻り値

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

リターン コード 説明
NDIS_STATUS_SUCCESS
 NdisRetreatNetBufferListDataStart は、 DataOffset メンバーの値を小さくするか、新しいストレージを割り当てることによって、すべてのNET_BUFFER構造体にデータ領域を正常に割り当てることに成功しました。
NDIS_STATUS_RESOURCES
 リソースが不足しているため、NdisRetreatNetBufferListDataStart が失敗しました。
NDIS_STATUS_FAILURE
 リソースが不足している以外の理由で NdisRetreatNetBufferListDataStart が失敗しました。

注釈

NdisRetreatNetBufferListDataStart の呼び出しは、NET_BUFFER_LIST構造体のすべてのNET_BUFFER構造体に対する NdisRetreatNetBufferDataStart 関数。 NdisRetreatNetBufferListDataStart は、すべてのNET_BUFFER構造体の DataOffset メンバーの値を減らすことで要求を満たそうとします。 使用できる未使用のデータ領域が不足している場合、この関数は新しいバッファーと MDL を割り当て、新しい MDL を NET_BUFFER 構造体の MDL チェーンの先頭にチェーンします。

を呼び出します。 以前の NdisRetreatNetBufferListDataStart 呼び出しで要求されたデータ領域を解放するための NdisAdvanceNetBufferListDataStart 関数。 または、ドライバーは を呼び出すことができます。NET_BUFFER_LIST構造体の各NET_BUFFER構造体の NdisAdvanceNetBufferDataStart 関数。 NdisAdvanceNetBufferListDataStart を呼び出す方が効率的です。

要件

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

こちらもご覧ください

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisAdvanceNetBufferListDataStart NdisRetreatNetBufferDataStart

NetAllocateMdl

NetFreeMdl