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 は、次のいずれかを返します。
| リターン コード | 説明 |
|---|---|
|
NdisRetreatNetBufferDataStart は、未使用の データ領域 を使用するか、新しいストレージを割り当てることによって、使用 されたデータ領域 が正常に割り当てられます。 |
|
リソースが不足しているため、NdisRetreatNetBufferDataStart が失敗しました。 |
|
リソースが不足している以外の理由で 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) |