KsFastPropertyHandler, fonction (ks.h)
La fonction KsFastPropertyHandler gère les requêtes de propriétés rapides via IOCTL_KS_PROPERTY. Elle répond à tous les identificateurs de propriété 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 KsFastPropertyHandler(
PFILE_OBJECT FileObject,
PKSPROPERTY Property,
ULONG PropertyLength,
PVOID Data,
ULONG DataLength,
PIO_STATUS_BLOCK IoStatus,
ULONG PropertySetsCount,
const KSPROPERTY_SET *PropertySet
);
Paramètres
FileObject
Property
PropertyLength
Data
DataLength
IoStatus
PropertySetsCount
PropertySet
Valeur de retour
La fonction KsFastPropertyHandler retourne TRUE si la requête a été gérée, ou FALSE si la requête n’a pas été gérée. Si FAUX est retourné, un IRP est généré. Si la requête a été gérée, la fonction définit l’élément IoStatus->Information, soit en le définissant sur zéro en raison d’une erreur interne, soit par le biais d’un gestionnaire de propriétés qui le définit. Le gestionnaire de propriétés définit également le champ IoStatus->Status lorsque la propriété est réellement gérée.
Remarques
Le propriétaire d’un jeu de propriétés peut effectuer un préfiltrage ou une post-filtrage de la gestion des propriétés, ainsi que le traitement des demandes effectuées via l’interface de répartition rapide des E/S pour le contrôle d’appareil. La fonction KsFastPropertyHandler est utilisée uniquement pour traiter les requêtes qui peuvent être traitées 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 |