KSMETHOD-Struktur

Artikel
02/07/2024

Die KSMETHOD-Struktur gibt eine einzelne Kernelstreamingmethode innerhalb eines Methodensatzes an.

Die Strukturen KSEVENT, KSMETHOD und KSPROPERTY sind Aliase für die KSIDENTIFIER-Struktur . Daher sind ihre Definitionen identisch.

Syntax

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

Member

Set

Gibt eine GUID an, die einen Kernelstreamingmethodensatz identifiziert.

Weitere Informationen zu Methodensatz-GUIDs finden Sie weiter unten im Abschnitt Hinweise .

Id

Gibt das Element des Methodensatzes an.

Flags

Gibt den Anforderungstyp an. Siehe auch die KSMETHOD_TYPE_Xxx Flags für KSMETHOD_ITEM).

Eine Anforderung kann eine Kombination der in der folgenden Tabelle aufgeführten Werte enthalten.

Wert	Typ der Methodenanforderung
KSMETHOD_TYPE_BASICSUPPORT	Gibt an, den Minitreiber abzufragen, um zu ermitteln, 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 gelesen, in beide oder weder geschrieben werden. Der Minidriver verwendet die KSMETHOD_ITEM-Struktur , um die Auswirkung der Methode auf die Parameter anzugeben.
KSMETHOD_TYPE_SETSUPPORT	Gibt an, den Minidriver abzufragen, um zu ermitteln, ob er den angegebenen Methodensatz unterstützt.
KSMETHOD_TYPE_TOPOLOGY	Gibt an, dass die angegebene Methode vom Typ KSM_NODE ist, wobei das NodeId-Element der Bezeichner des Topologieknotens ist. Legen Sie dieses Flag nicht selbst fest. stattdessen ODER mit anderen Flags aus dieser Liste.

Hinweise

Microsoft stellt mehrere systemdefinierte Methodensatz-GUIDs bereit. Minidriver geben eine dieser GUIDs im Element Festlegen an. Kernelstreamingmethodensätze beginnen in der Regel mit einem Präfix KSMETHODSETID . Kernelstreamingmethodensätze werden in ks.h, ksmedia.h, bdamedia.h und möglicherweise anderen Headerdateien definiert.

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 verarbeitet. Weitere Informationen finden Sie unter KS-Methoden.