KsFastMethodHandler, fonction (ks.h)

Article
02/07/2025

La fonction KsFastMethodHandler gère les méthodes rapides demandées via IOCTL_KS_METHOD. Elle 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 de fichier sur lequel la requête a été effectuée.

[in] Method

Spécifie le paramètre de méthode d’origine. Cela sera toujours sur FILE_LONG_ALIGNMENT, mais peut ne pas ê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é 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 utilisée pour retourner l’état d’erreur et les 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 de jeu de méthodes.

Valeur de retour

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 un préfiltrage ou une post-filtrage de la gestion des méthodes à l’aide des fonctions KsFastMethodHandler et KsMethodHandler . La fonction KsFastMethodHandler est utilisée pour traiter les demandes effectuées via l’interface de répartition rapide des E/S pour device Control. Il est utilisé uniquement pour traiter les demandes qui peuvent être remplies rapidement. Le paramètre Wait de la fonction d’E/S rapide n’est pas passé et est supposé être TRUE.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Voir aussi

KsMethodHandler

Partager via