Udostępnij przez


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. W związku z tym ich definicje są identyczne.

Syntax

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

Members

Set

Określa identyfikator GUID identyfikujący zestaw metod przesyłania strumieniowego jądra.

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

Id

Określa element członkowski zestawu metod.

Flags

Określa typ żądania. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Żądanie może zawierać kombinację wartości wymienionych w poniższej tabeli.

Value Typ żądania metody
KSMETHOD_TYPE_BASICSUPPORT Wskazuje, aby wysłać zapytanie do minidrivera w celu określenia, czy obsługuje określoną metodę zestawu metod.
KSMETHOD_TYPE_SEND Wskazuje, że minidriver powinien wykonać określoną metodę. Wpływ metody na podane parametry musi być znany klientowi, czyli czy parametry są odczytywane, zapisywane w obu tych parametrach, czy też nie. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Wskazuje, aby wysłać zapytanie do minidrivera w celu określenia, czy obsługuje określony zestaw metod.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Nie ustawiaj tej flagi samodzielnie; zamiast tego lub z innymi flagami z tej listy.

Remarks

Firma Microsoft udostępnia kilka identyfikatorów GUID zestawu metod zdefiniowanych przez system. 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.

Aby uzyskać więcej informacji na temat zdarzeń przesyłania strumieniowego jądra, zobacz Właściwości ks, zdarzenia i metody.

Klient może użyć żądania IOCTL_KS_METHOD wraz ze strukturą KSMETHOD do wykonywania metod na obiekcie przesyłania strumieniowego jądra, który obsługuje minidriver. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE