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 demande de méthode en cours de traitement.

[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 retournée

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 le IO_STATUS_BLOCK. Champ d’informations du PIRP. Élément IoStatus dans l’IRP sur zéro en raison d’une erreur interne, sauf si l’élément est défini par un gestionnaire de méthode. La fonction ne définit pas le IO_STATUS_BLOCK. Champ d’état ni terminer l’IRP.

Remarques

Le propriétaire d’un jeu de méthodes peut effectuer le préfiltrage ou le postfiltrage de la gestion de la méthode à l’aide des fonctions KsMethodHandler et KsFastMethodHandler .

Configuration requise

Voir aussi

KsFastMethodHandler

KsMethodHandlerWithAllocator