KsMethodHandler, fonction (ks.h)
La fonction KsMethodHandler gère les méthodes demandées via IOCTL_KS_METHOD. Il fonctionne avec tous les identificateurs de méthode définis par les jeux. La fonction ne peut être appelée qu’à PASSIVE_LEVEL.
Syntaxe
KSDDKAPI NTSTATUS KsMethodHandler(
[in] PIRP Irp,
[in] ULONG MethodSetsCount,
[in] const KSMETHOD_SET *MethodSet
);
Paramètres
[in] Irp
Spécifie l’IRP avec la requête de méthode gérée.
[in] MethodSetsCount
Indique le nombre de structures de jeu de méthodes passées.
[in] MethodSet
Spécifie le pointeur vers la liste des informations de jeu de méthodes.
Valeur de retour
La fonction KsMethodHandler retourne STATUS_SUCCESS en cas de réussite, ou une erreur spécifique à la méthode gérée en cas d’échec. La fonction définit toujours la IO_STATUS_BLOCK. Champ d’informations du PIRP. Élément IoStatus au sein de l’IRP à zéro en raison d’une erreur interne, sauf si l’élément est défini par un gestionnaire de méthodes. La fonction ne définit pas la IO_STATUS_BLOCK. Champ d’état ni terminer l’IRP.
Remarques
Le propriétaire d’un jeu de méthodes peut effectuer un préfiltrage ou une post-filtrage de la gestion des méthodes à l’aide des fonctions KsMethodHandler et KsFastMethodHandler .
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |