Fonction de rappel PFNKSFASTHANDLER (ks.h)

Article
02/29/2024

KStrFastHandler est une routine fournie par un pilote qui gère une requête de propriété ou de méthode sans créer d’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 demande a été effectuée.

[in] Request

Spécifie le paramètre de propriété d’origine. Ce sera toujours sur FILE_LONG_ALIGNMENT, mais ne peut pas l’ê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 des status d’erreur et des informations. Ces informations sont ensuite copiées dans la structure d’E/S d’origine status à l’achèvement.

Valeur retournée

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 demande.

Remarques

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ks.h (inclure Ks.h)

Partager via