Fonction de rappel PFNKSFASTHANDLER (ks.h)

Article
02/07/2025

KStrFastHandler est une routine fournie par le pilote qui gère une requête de propriété ou de méthode sans la création d’un IRP.

Syntaxe

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Paramètres

[in] FileObject

Spécifie l’objet de fichier sur lequel la requête a été effectuée.

[in] Request

Spécifie le paramètre de propriété d’origine. Cela sera toujours sur FILE_LONG_ALIGNMENT, mais ne peut pas être sur FILE_QUAD_ALIGNMENT.

[in] RequestLength

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

[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. Ces informations sont ensuite copiées dans la structure d’état d’E/S d’origine à l’achèvement.

Valeur de retour

KStrFastHandler retourne TRUE si l’appel a été géré. Si l’appel n’a pas été géré, il retourne FALSE et un IRP est généré pour gérer la requête.

Remarques

Le minidriver fournit un point d’entrée pour cette routine dans KSFASTPROPERTY_ITEM ou KSFASTMETHOD_ITEM.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	ks.h (include Ks.h)

Partager via