Compartir a través de


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. Por lo tanto, sus definiciones son idénticas.

Syntax

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

Members

Set

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

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

Id

Especifica el miembro del conjunto de métodos.

Flags

Especifica el tipo de solicitud. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

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

Value Tipo de solicitud de método
KSMETHOD_TYPE_BASICSUPPORT Indica que debe 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. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Indica que debe consultar el minidriver para determinar si admite el conjunto de métodos especificado.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. No establezca esta marca por sí sola; en su lugar, OR con otras marcas de esta lista.

Remarks

Microsoft proporciona varios GUID de conjunto de métodos definidos por el sistema. 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.

Para obtener más información sobre los eventos de streaming de kernel, consulte propiedades, eventos y métodos de KS.

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. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE