Structure KSMETHOD
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.
Configuration requise
En-tête : ks.h (include Ks.h)