Partager via


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. Par conséquent, leurs définitions sont identiques.

Syntax

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

Members

Set

Spécifie un GUID qui identifie un jeu de méthodes de diffusion en continu du noyau.

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

Id

Spécifie le membre du jeu de méthodes.

Flags

Spécifie le type de requête. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Une requête peut contenir une combinaison des valeurs répertoriées dans le tableau suivant.

Value Type de requête de méthode
KSMETHOD_TYPE_BASICSUPPORT Indique d’interroger le minidriver pour déterminer s’il prend en charge la méthode spécifiée du jeu de méthodes.
KSMETHOD_TYPE_SEND Indique que le minidriver doit exécuter la méthode spécifiée. L’effet de la méthode sur les paramètres donnés doit être connu du client, c’est-à-dire si les paramètres sont lus, écrits à la fois ou non. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Indique d’interroger le minidriver pour déterminer s’il prend en charge le jeu de méthodes spécifié.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Ne définissez pas cet indicateur par lui-même ; au lieu de cela, OU avec d’autres indicateurs de cette liste.

Remarks

Microsoft fournit plusieurs GUID définis par le système. 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.

Pour plus d’informations sur les événements de diffusion en continu du noyau, consultez propriétés, événements et méthodes KS.

Un client peut utiliser la requête IOCTL_KS_METHOD avec la structure KSMETHOD pour exécuter des méthodes sur un objet de diffusion en continu du noyau géré par le minidriver. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE