KSMETHOD 構造体

  • [アーティクル]

KSMETHOD 構造体は、メソッド セット内で 1 つのカーネル ストリーミング メソッドを指定します。

KSEVENT、KSMETHOD、および KSPROPERTY 構造体は、KSIDENTIFIER 構造体のエイリアスです。 そのため、それらの定義は同じです。

構文

struct KSMETHOD {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

メンバー

Set

カーネル ストリーミング メソッド セットを識別する GUID を指定します。

メソッド セット GUID の詳細については、以下の「備考」セクションを参照してください。

Id

メソッド セットのメンバーを指定します。

Flags

要求の種類を指定します。 また、KSMETHOD_ITEM の KSMETHOD_TYPE_Xxx フラグも参照してください。

要求には、次の表に示す値の組み合わせを含めることができます。

値 メソッド要求の種類
KSMETHOD_TYPE_BASICSUPPORT ミニドライバーに対してクエリを実行し、メソッド セットの指定されたメソッドがサポートされているかどうかを判断することを示します。
KSMETHOD_TYPE_SEND ミニドライバーが指定したメソッドを実行する必要があることを示します。 指定されたパラメーターに対するメソッドの効果は、クライアントに認識されている必要があります。つまり、パラメーターの読み取り元、書き込み元、書き込み元、両方、またはどちらも認識されません。 ミニドライバーは、KSMETHOD_ITEM 構造体を使用して、パラメーターに対するメソッドの効果を指定します。
KSMETHOD_TYPE_SETSUPPORT ミニドライバーに対してクエリを実行し、指定したメソッド セットがサポートされているかどうかを判断することを示します。
KSMETHOD_TYPE_TOPOLOGY 指定したメソッドの種類が KSM_NODE であることを示します。ここで、NodeId メンバーはトポロジ ノードの識別子です。 このフラグは単独で設定しないでください。代わりに、このリストの他のフラグを指定します。

備考

Microsoft は、いくつかのシステム定義メソッド セット GUID を提供しています。 ミニドライバーは、Set メンバーでこれらの GUID のいずれかを指定します。 カーネル ストリーミング メソッド セットは、通常、KSMETHODSETID プレフィックスで始まります。 カーネル ストリーミング メソッド セットは、ks.h、ksmedia.h、bdamedia.h、および場合によっては他のヘッダー ファイルで定義されます。

カーネル ストリーミング イベントの詳細については、「KS のプロパティ、イベント、およびメソッド」を参照してください。

クライアントは、IOCTL_KS_METHOD 要求と KSMETHOD 構造体を使用して、ミニドライバーが処理するカーネル ストリーミング オブジェクトに対してメソッドを実行できます。 詳細については、「KS メソッド」を参照してください。

要件

ヘッダー: ks.h (Ks.hを含む)

関連項目

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE