PCMETHOD_ITEM 構造体 (portcls.h)

PCMETHOD_ITEM構造体は、フィルター、ピン、またはノードでサポートされるメソッドを記述します。

構文

typedef struct {
  const GUID          *Set;
  ULONG               Id;
  ULONG               Flags;
  PCPFNMETHOD_HANDLER Handler;
} PCMETHOD_ITEM, *PPCMETHOD_ITEM;

メンバー

Set

メソッド セットを指定します。 このメンバーは、メソッド セットを一意に識別する GUID へのポインターです。

Id

メソッド ID を指定します。 このメンバーは、メソッド セット内のメソッド項目を識別します。 メソッド セットに n 個の項目が含まれている場合、有効なメソッド ID は 0 ~ n-1 の範囲の整数です。

Flags

メソッドが使用するパラメーター の受け渡しとメモリ アクセスの種類を指定します。 このメンバーは、次の表の 1 つ以上のフラグ ビットのビットごとの OR に設定できます。

フラグ ビット	意味
PCMETHOD_ITEM_FLAG_MODIFY	メソッドは から読み取り、パラメーター バッファーに書き込みます。
PCMETHOD_ITEM_FLAG_NONE	メソッドはパラメーター バッファーを使用しません。
PCMETHOD_ITEM_FLAG_READ	メソッドは、パラメーター バッファーから読み取ります。
PCMETHOD_ITEM_FLAG_SOURCE	メソッドは、メモリ アクセスを試みる前にメモリ ページをプローブしてロックします。
PCMETHOD_ITEM_FLAG_WRITE	メソッドはパラメーター バッファーに書き込みます。

Handler

メソッド ハンドラー ルーチンへのポインター。 このメンバーは、次のように定義PCPFNMETHOD_HANDLER型の関数ポインターです。

  typedef NTSTATUS (*PCPFNMETHOD_HANDLER)
  (
      IN PPCMETHOD_REQUEST  MethodRequest
  );

Handler ルーチンを呼び出すとき、呼び出し元は単一の呼び出しパラメーターを渡します。これは、PCMETHOD_REQUEST型の構造体へのポインターです。

注釈

WDM オーディオ サブシステムでは、現在、フィルター インスタンスまたはピン インスタンスのメソッドはサポートされていません。 この制限により、ノードでのメソッドのサポートも除外されます。

PCAUTOMATION_TABLE構造体には、PCMETHOD_ITEM構造体の配列へのポインターが含まれています。

要件

要件	値
Header	portcls.h (Portcls.h を含む)

こちらもご覧ください

PCMETHOD_REQUEST