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を含む)