Estructura KSMETHOD
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.
Requisitos
Encabezado: ks.h (incluya Ks.h)