次の方法で共有

NDIS_PD_POST_AND_DRAIN_BUFFER_LIST コールバック関数 (ndis.h)

  • [アーティクル]

PacketDirect (PD) プラットフォームは、PD 対応ミニポート ドライバーの PDPostAndDrainBufferList 関数を呼び出して、PD_BUFFER 構造体を PD 送信/受信キューにポストし、完了した以前にポストされた PD_BUFFER 構造体をドレインします。

注NDIS_PD_POST_AND_DRAIN_BUFFER_LIST 型を使用して関数を宣言する必要があります。 詳細については、次の例のセクションを参照してください。

 

構文

NDIS_PD_POST_AND_DRAIN_BUFFER_LIST NdisPdPostAndDrainBufferList;

VOID() NdisPdPostAndDrainBufferList(
  [in, out] NDIS_PD_QUEUE *Queue,
  [in, out] PD_BUFFER **PostBufferListHead,
  [in, out] PD_BUFFER ***DrainBufferListTail,
  [in]      ULONG MaxDrainCount
)
{...}

パラメーター

[in, out] Queue

ポストされたバッファーを受信し、完了したバッファーが削除される送信または受信キューへのポインター。

[in, out] PostBufferListHead

投稿リストの先頭。 プロバイダーは、この一覧のバッファーを削除し、キューに追加します。

[in, out] DrainBufferListTail

ドレイン リストの末尾。 プロバイダーは、キュー から完了したバッファーを削除し、この一覧に追加します。

[in] MaxDrainCount

ドレインする PD_BUFFER 構造体の最大量。 プロバイダーは、この量を超えないようにする必要があります。 1 つの L2 パケット 数を構成する部分的な PD_BUFFER 構造体のセットは 1 です。

戻り値

このコールバック関数は値を返しません。

備考

プロバイダーは、PostBufferList からバッファーを削除し、それらをキューに配置します。これは、リスト内のヘッド バッファーから始まり、PostBufferList が空であるか、キューがいっぱいになるまで (またはほぼ満杯になるまで) 次のバッファーに進みます。 プロバイダーは PostListHead に進み、新しいリスト ヘッドを呼び出し元に返します。 また、プロバイダーはキューから完成したバッファーを削除し、DrainBufferList の末尾に挿入し、新しい DrainBufferList 末尾をクライアントに返します。

注 プロバイダーは、ポストされるバッファーのスペースを開くために、できるだけ多くのバッファーをドレインする必要があります。 PostBufferList と DrainBufferList は、不整合なバッファー リストであることが保証されます (クライアントは、バッファー リストの先頭を PostBufferListHead として提供したり、DrainBufferListTail と同じリストの末尾を提供したりすることはありません)。
 
また、クライアントは空のポスト バッファー リストを渡して、新しいバッファーをポストせずに完了したバッファーだけをドレインすることもできます。 また、クライアントは MaxDrainCount を 0 に設定して、完了したバッファーをドレインせずに新しいバッファーをポストすることもできます。 まれに、クライアントは空のポスト バッファー リストと MaxDrainCount を 0 の両方で呼び出すことができます。 プロバイダーは、それ以外の場合を想定して、このような呼び出しを適切に処理することはできません (操作なしなど)。

の例

PDPostAndDrainBufferList 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数の種類のセットが用意されています。 関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。

たとえば、"MyPDPostAndDrainBufferList" という名前の PDPostAndDrainBufferList 関数を定義するには、次のコード例に示すように NDIS_PD_POST_AND_DRAIN_BUFFER_LIST 型を使用します。

NDIS_PD_POST_AND_DRAIN_BUFFER_LIST MyPDPostAndDrainBufferList;

次に、次のように関数を実装します。

_Use_decl_annotations_
VOID
 MyPDPostAndDrainBufferList(
    NDIS_PD_QUEUE*  Queue,
    PD_BUFFER**  PostBufferListHead,
    PD_BUFFER*** DrainBufferListTail,
    ULONG  MaxDrainCount
    )
  {...}

NDIS_PD_POST_AND_DRAIN_BUFFER_LIST 関数の種類は、Ntddndis.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈により、ヘッダー ファイル内の NDIS_PD_POST_AND_DRAIN_BUFFER_LIST 関数型に適用される注釈が使用されます。 関数宣言の要件の詳細については、「ndis ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

この関数のポインターの間接参照を示すコード スニペットの例を次に示します。

PD_BUFFER* PostHead = NULL;
PD_BUFFER** PostTail = &PostHead;
PD_BUFFER* DrainHead = NULL;
PD_BUFFER** DrainTail = &DrainHead;

PD_BUFFER* bufX = <allocated PD_BUFFER>;

bufX->NextPDBuffer = NULL;
*PostTail = bufX;
PostTail = &bufX->NextPDBuffer;

// BEFORE:
//PostHead == bufX
//PostTail == &bufZ->NextPDBuffer
//DrainHead == NULL
//DrainTail == &DrainHead

NDIS_PD_POST_AND_DRAIN_BUFFER_LIST(
          Queue,
          &PostHead,
          &DrainTail,
          32);

// AFTER:
//PostHead == bufY
//PostTail == &bufZ->NextPDBuffer
//DrainHead == buf1
//DrainTail == &buf5->NextPDBuffer

必要条件

要件 価値
サポートされる最小クライアント Windows 10
サポートされる最小サーバー Windows Server 2016
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndis.h
IRQL <= DISPATCH_LEVEL