Поделиться через


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. Таким образом, их определения идентичны.

Syntax

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

Members

Set

Указывает GUID, определяющий набор методов потоковой передачи ядра.

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

Id

Указывает член набора методов.

Flags

Указывает тип запроса. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Запрос может содержать сочетание значений, перечисленных в следующей таблице.

Value Тип запроса метода
KSMETHOD_TYPE_BASICSUPPORT Указывает на запрос мини-driver, чтобы определить, поддерживает ли он указанный метод набора методов.
KSMETHOD_TYPE_SEND Указывает, что мини-driver должен выполнить указанный метод. Эффект метода для заданных параметров должен быть известен клиенту, то есть, считываются ли параметры из, записываются в оба или ни в другое. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Указывает на запрос мини-driver, чтобы определить, поддерживает ли он указанный набор методов.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Не устанавливайте этот флаг самостоятельно; вместо этого или с другими флагами из этого списка.

Remarks

Корпорация Майкрософт предоставляет несколько системных идентификаторов GUID методов. 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.

Дополнительные сведения о событиях потоковой передачи ядра см. в свойствах, событиях и методах KS.

Клиент может использовать запрос IOCTL_KS_METHOD вместе со структурой KSMETHOD для выполнения методов в объекте потоковой передачи ядра, который обрабатывает мини-driver. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE