PCAUTOMATION_TABLE 構造体 (portcls.h)

[アーティクル]
02/26/2024

PCAUTOMATION_TABLE構造体には、プロパティ、メソッド、およびイベントのミニポートドライバーのマスターテーブルが含まれています。

構文

typedef struct {
  ULONG                 PropertyItemSize;
  ULONG                 PropertyCount;
  const PCPROPERTY_ITEM *Properties;
  ULONG                 MethodItemSize;
  ULONG                 MethodCount;
  const PCMETHOD_ITEM   *Methods;
  ULONG                 EventItemSize;
  ULONG                 EventCount;
  const PCEVENT_ITEM    *Events;
  ULONG                 Reserved;
} PCAUTOMATION_TABLE, *PPCAUTOMATION_TABLE;

メンバー

PropertyItemSize

使用されるプロパティ構造体のサイズをバイト単位で指定します。このメンバーを sizeof(PCPROPERTY_ITEM) 以上に設定します。次の「解説」セクションを参照してください。

PropertyCount

Properties 配列内のプロパティ項目の数を指定します。

Properties

フィルターのプロパティ配列へのポインター。これは、 PCPROPERTY_ITEM 構造体の配列です。

MethodItemSize

使用するメソッド構造体のサイズをバイト単位で指定します。このメンバーを sizeof(PCMETHOD_ITEM) 以上に設定します。次の「解説」セクションを参照してください。

MethodCount

Methods 配列内のメソッド項目の数を指定します。

Methods

フィルターのメソッドの配列へのポインター。これは、 PCMETHOD_ITEM 構造体の配列です。

EventItemSize

使用されるイベント構造体のサイズをバイト単位で指定します。このメンバーを sizeof(PCEVENT_ITEM) 以上に設定します。次の「解説」セクションを参照してください。

EventCount

Events 配列内のイベント項目の数を指定します。

Events

フィルターのイベント配列へのポインター。これは、 PCEVENT_ITEM 構造体の配列です。

Reserved

予約済み。 0 に初期化します。

注釈

構造体の項目ポインターには NULL を指定できます。この場合、対応するカウントは 0 にする必要があります。長さが 0 でない項目テーブルの場合、項目サイズは、ヘッダーファイル portcls.h で定義されている対応する項目構造のサイズよりも小さくしないでください。プロパティ、イベント、またはメソッド項目の最小サイズは、 それぞれ sizeof(PCPROPERTY_ITEM)、 sizeof(PCEVENT_ITEM)、または sizeof(PCMETHOD_ITEM) です。アイテムのサイズはこれより大きくなる可能性があります。その場合、アイテム構造の後にミニポートドライバーが追加するプライベートデータが続きます。項目のサイズは 8 の倍数にする必要があります。

IMiniport::GetDescription メソッドは、ミニポートドライバーのオートメーションテーブルを指定するPCAUTOMATION_TABLE構造体を指すPCFILTER_DESCRIPTOR構造体を出力します。