KsFastPropertyHandler, fonction (ks.h)
La fonction KsFastPropertyHandler gère les demandes de propriétés rapides via IOCTL_KS_PROPERTY. Il 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 retournée
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 FALSE 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 lui affectant la valeur zéro en raison d’une erreur interne, soit en le définissant par un gestionnaire de propriétés. Le gestionnaire de propriétés définit également le champ IoStatus-Status> quand la propriété est réellement gérée.
Remarques
Le propriétaire d’un jeu de propriétés peut effectuer le préfiltrage ou le postfiltrage de la gestion des propriétés, ainsi que le traitement des demandes effectuées via l’interface de distribution d’E/S rapide pour le contrôle de l’appareil. La fonction KsFastPropertyHandler est utilisée 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é être TRUE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |