Структура KSMETHOD

Статья
02/07/2024

Структура KSMETHOD указывает один метод потоковой передачи ядра в наборе методов.

Структуры KSEVENT, KSMETHOD и KSPROPERTY являются псевдонимами для структуры KSIDENTIFIER . Таким образом, их определения идентичны.

Синтаксис

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

Члены

Set

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

Дополнительные сведения о идентификаторах GUID набора методов см. в разделе Примечания ниже.

Id

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

Flags

Указывает тип запроса. Кроме того, см . флаги KSMETHOD_TYPE_Xxx для KSMETHOD_ITEM).

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

Значение	Тип запроса метода
KSMETHOD_TYPE_BASICSUPPORT	Указывает, что нужно запросить мини-диск, чтобы определить, поддерживает ли он указанный метод набора методов.
KSMETHOD_TYPE_SEND	Указывает, что мини-диск должен выполнить указанный метод. Влияние метода на заданные параметры должно быть известно клиенту, то есть о том, считываются ли параметры из, записываются в , как, так и ни из. Мини-диск использует структуру KSMETHOD_ITEM для указания влияния метода на параметры.
KSMETHOD_TYPE_SETSUPPORT	Указывает, что нужно запросить мини-диск, чтобы определить, поддерживает ли он указанный набор методов.
KSMETHOD_TYPE_TOPOLOGY	Указывает, что указанный метод имеет тип KSM_NODE, где элемент NodeId является идентификатором узла топологии. Не устанавливайте этот флаг самостоятельно; вместо этого или с другими флагами из этого списка.

Корпорация Майкрософт предоставляет несколько идентификаторов GUID набора системных методов. Мини-накопители указывают один из этих идентификаторов GUID в элементе Set . Наборы методов потоковой передачи ядра обычно начинаются с префикса KSMETHODSETID . Наборы методов потоковой передачи ядра определяются в ks.h, ksmedia.h, bdamedia.h и, возможно, в других файлах заголовков.

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

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