Structure KSMETHOD

Article
02/07/2024

La structure KSMETHOD spécifie une seule méthode de diffusion en continu de noyau dans un ensemble de méthodes.

Les structures KSEVENT, KSMETHOD et KSPROPERTY sont des alias pour la structure KSIDENTIFIER . Par conséquent, leurs définitions sont identiques.

Syntaxe

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

Membres

Set

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

Pour plus d’informations sur les GUID de jeu de méthodes, consultez la section Remarques ci-dessous.

Id

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

Flags

Spécifie le type de demande. Consultez également les indicateurs de KSMETHOD_TYPE_Xxx pour KSMETHOD_ITEM).

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

Valeur	Type de demande 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 dans les deux, ou non. Le minidriver utilise la structure KSMETHOD_ITEM pour spécifier l’effet de la méthode sur les paramètres.
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	Indique que la méthode spécifiée est de type KSM_NODE, où le membre NodeId est l’identificateur du nœud de topologie. Ne définissez pas cet indicateur seul ; à la place, OU avec d’autres indicateurs de cette liste.

Remarques

Microsoft fournit plusieurs GUID d’ensembles de méthodes définis par le système. Les mini-disques spécifient l’un de ces GUID dans le membre Set . Les jeux de méthodes de diffusion en continu du noyau commencent généralement par un préfixe KSMETHODSETID . Les ensembles de méthodes de diffusion en continu du noyau sont définis dans ks.h, ksmedia.h, bdamedia.h et éventuellement dans d’autres fichiers d’en-tête.

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 de noyau que le minidriver gère. Pour plus d’informations, consultez Méthodes KS.