Funzione KsFastPropertyHandler (ks.h)
La funzione KsFastPropertyHandler gestisce le richieste rapide delle proprietà tramite IOCTL_KS_PROPERTY. Risponde a tutti gli identificatori di proprietà definiti dai set contenuti anche nell'elenco di I/O veloce. Questa funzione può essere chiamata solo in PASSIVE_LEVEL.
Sintassi
KSDDKAPI BOOLEAN KsFastPropertyHandler(
PFILE_OBJECT FileObject,
PKSPROPERTY Property,
ULONG PropertyLength,
PVOID Data,
ULONG DataLength,
PIO_STATUS_BLOCK IoStatus,
ULONG PropertySetsCount,
const KSPROPERTY_SET *PropertySet
);
Parametri
FileObject
Property
PropertyLength
Data
DataLength
IoStatus
PropertySetsCount
PropertySet
Valore restituito
La funzione KsFastPropertyHandler restituisce TRUE se la richiesta è stata gestita o FALSE se la richiesta non è stata gestita. Se viene restituito false, viene generato un IRP. Se la richiesta è stata gestita, la funzione imposta l'elemento IoStatus->Information, impostandolo su zero a causa di un errore interno o impostandolo tramite un gestore di proprietà. Il gestore proprietà imposta anche il campo IoStatus->Status quando la proprietà viene effettivamente gestita.
Osservazioni
Il proprietario di un set di proprietà può eseguire prefiltri o postfiltri della gestione delle proprietà, nonché l'elaborazione delle richieste effettuate tramite l'interfaccia di invio di I/O veloce per il controllo del dispositivo. La funzione KsFastPropertyHandler viene usata solo per elaborare le richieste che possono essere soddisfatte rapidamente. Il parametro Wait della funzione di I/O veloce non viene passato e si presuppone che sia TRUE.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |