Estructura KSMETHOD

Artículo
06/14/2023

La estructura KSMETHOD especifica un único método de streaming de kernel dentro de un conjunto de métodos.

Las estructuras KSEVENT, KSMETHOD y KSPROPERTY son alias para la estructura KSIDENTIFIER . Por lo tanto, sus definiciones son idénticas.

Sintaxis

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

Miembros

Set

Especifica un GUID que identifica un conjunto de métodos de streaming de kernel.

Para obtener más información sobre los GUID del conjunto de métodos , vea la sección Comentarios a continuación.

Id

Especifica el miembro del conjunto de métodos.

Flags

Especifica el tipo de solicitud. Consulte también las marcas de KSMETHOD_TYPE_Xxx para KSMETHOD_ITEM).

Una solicitud puede contener una combinación de los valores enumerados en la tabla siguiente.

Valor	Tipo de solicitud de método
KSMETHOD_TYPE_BASICSUPPORT	Indica que se va a consultar el minidriver para determinar si admite el método especificado del conjunto de métodos.
KSMETHOD_TYPE_SEND	Indica que el minidriver debe ejecutar el método especificado. El efecto del método en los parámetros especificados debe conocerse al cliente, es decir, si los parámetros se leen, escriben en, ambos o ninguno. El minidriver usa la estructura KSMETHOD_ITEM para especificar el efecto del método en los parámetros.
KSMETHOD_TYPE_SETSUPPORT	Indica que se va a consultar el minidriver para determinar si admite el conjunto de métodos especificado.
KSMETHOD_TYPE_TOPOLOGY	Indica que el método especificado es de tipo KSM_NODE, donde el miembro NodeId es el identificador del nodo de topología. No establezca esta marca por sí sola; en su lugar, O bien con otras marcas de esta lista.

Comentarios

Microsoft proporciona varios GUID de conjunto de métodos definidos por el sistema. Los minidrivers especifican uno de estos GUID en el miembro Set . Los conjuntos de métodos de streaming de kernel suelen comenzar con un prefijo KSMETHODSETID . Los conjuntos de métodos de streaming de kernel se definen en ks.h, ksmedia.h, bdamedia.h y, posiblemente, en otros archivos de encabezado.

Para obtener más información sobre los eventos de streaming de kernel, vea Propiedades de KS, Eventos y Métodos.

Un cliente puede usar la solicitud de IOCTL_KS_METHOD junto con la estructura KSMETHOD para ejecutar métodos en un objeto de streaming de kernel que controla el minidriver. Para obtener más información, vea Métodos KS.