Freigeben über


KSMETHOD structure

The KSMETHOD structure specifies a single kernel streaming method within a method set.

The KSEVENT, KSMETHOD, and KSPROPERTY structures are aliases for the KSIDENTIFIER structure. Daher sind ihre Definitionen identisch.

Syntax

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

Members

Set

Gibt eine GUID an, die einen Kernelstreamingmethodensatz identifiziert.

For more information about method set GUIDs, see the Remarks section below.

Id

Gibt das Element des Methodensatzes an.

Flags

Gibt den Anforderungstyp an. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Eine Anforderung kann eine Kombination der werte enthalten, die in der folgenden Tabelle aufgeführt sind.

Value Typ der Methodenanforderung
KSMETHOD_TYPE_BASICSUPPORT Gibt an, den Minidriver abzufragen, um festzustellen, ob er die angegebene Methode des Methodensatzes unterstützt.
KSMETHOD_TYPE_SEND Gibt an, dass der Minidriver die angegebene Methode ausführen soll. Die Auswirkung der Methode auf die angegebenen Parameter muss dem Client bekannt sein, d. h., ob die Parameter ausgelesen, in beides oder keines geschrieben werden. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Gibt an, den Minidriver abzufragen, um festzustellen, ob er den angegebenen Methodensatz unterstützt.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Legen Sie diese Kennzeichnung nicht selbst fest; Stattdessen OR it with other flags from this list.

Remarks

Microsoft stellt mehrere systemdefinierte Methodensatz-GUIDs bereit. Minidrivers specify one of these GUIDs in the Set member. Kernel streaming method sets typically begin with a KSMETHODSETID prefix. Kernel streaming method sets are defined in ks.h, ksmedia.h, bdamedia.h, and possibly other header files.

Weitere Informationen zu Kernelstreamingereignissen finden Sie unter KS-Eigenschaften, Ereignisse und Methoden.

Ein Client kann die IOCTL_KS_METHOD Anforderung zusammen mit der KSMETHOD-Struktur verwenden, um Methoden für ein Kernelstreamingobjekt auszuführen, das der Minidriver behandelt. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE