KsFastMethodHandler, fonction (ks.h)

Article
08/07/2023

La fonction KsFastMethodHandler gère les méthodes rapides demandées via IOCTL_KS_METHOD. Il répond à tous les identificateurs de méthode définis par les jeux qui sont également contenus dans la liste d’E/S rapides. Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL.

Syntaxe

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

Paramètres

[in] FileObject

Spécifie l’objet file sur lequel la demande a été effectuée.

[in] Method

Spécifie le paramètre de méthode d’origine. Ce sera toujours sur FILE_LONG_ALIGNMENT, mais peut ne pas l’être sur FILE_QUAD_ALIGNMENT.

[in] MethodLength

Spécifie la longueur indiquée par l’appelant du paramètre de méthode.

[in, out] Data

Spécifie le paramètre de données non alignées d’origine.

[in] DataLength

Spécifie la longueur indiquée par l’appelant du paramètre de données.

[out] IoStatus

Spécifie une structure alignée qui est utilisée pour retourner des status d’erreur et des informations.

[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 relatives au jeu de méthodes.

Valeur retournée

La fonction KsFastMethodHandler retourne TRUE si la requête est gérée, ou FALSE si la requête n’est pas gérée. Si la requête n’est pas gérée, un IRP est généré. Si la requête a été gérée, la fonction définit l’élément IoStatus-Information> sur zéro en raison d’une erreur interne ou l’élément est défini par un gestionnaire de méthode. Le gestionnaire de méthode définit également le champ IoStatus-Status> lorsque la méthode est gérée.

Remarques

Le propriétaire d’un jeu de méthodes peut effectuer le préfiltrage ou le postfiltrage de la gestion de méthode à l’aide des fonctions KsFastMethodHandler et KsMethodHandler . La fonction KsFastMethodHandler est utilisée pour traiter les demandes effectuées via l’interface de distribution d’E/S rapide pour le contrôle d’appareil. Il est utilisé uniquement pour traiter les demandes qui peuvent être traitées rapidement. Le paramètre Wait de la fonction d’E/S rapide n’est pas passé et est supposé avoir la valeur TRUE.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib

Voir aussi

KsMethodHandler

Partager via