KsFastPropertyHandler-Funktion (ks.h)
Die KsFastPropertyHandler-Funktion verarbeitet schnelle Eigenschaftenanforderungen über IOCTL_KS_PROPERTY. Sie reagiert auf alle Eigenschaftenbezeichner, die von den Sätzen definiert werden, die ebenfalls in der Liste der schnellen E/A enthalten sind. Diese Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.
Syntax
KSDDKAPI BOOLEAN KsFastPropertyHandler(
PFILE_OBJECT FileObject,
PKSPROPERTY Property,
ULONG PropertyLength,
PVOID Data,
ULONG DataLength,
PIO_STATUS_BLOCK IoStatus,
ULONG PropertySetsCount,
const KSPROPERTY_SET *PropertySet
);
Parameter
FileObject
Property
PropertyLength
Data
DataLength
IoStatus
PropertySetsCount
PropertySet
Rückgabewert
Die KsFastPropertyHandler-Funktion gibt TRUE zurück, wenn die Anforderung verarbeitet wurde, oder FALSE , wenn die Anforderung nicht verarbeitet wurde. Wenn FALSE zurückgegeben wird, wird ein IRP generiert. Wenn die Anforderung verarbeitet wurde, legt die Funktion das IoStatus-Information-Element> fest, entweder durch Festlegen auf Null aufgrund eines internen Fehlers oder durch einen Eigenschaftenhandler, der es festlegt. Der Eigenschaftenhandler legt auch das Feld IoStatus-Status> fest, wenn die Eigenschaft tatsächlich behandelt wird.
Hinweise
Der Besitzer eines Eigenschaftensatzes kann eine Vor- oder Nachfilterung der Eigenschaftenbehandlung sowie Die Verarbeitung von Anforderungen durchführen, die über die schnelle E/A-Verteilerschnittstelle für die Gerätesteuerung gesendet werden. Die KsFastPropertyHandler-Funktion wird nur verwendet, um Anforderungen zu verarbeiten, die schnell erfüllt werden können. Der Wait-Parameter der Schnellen E/A-Funktion wird nicht übergeben und als TRUE angenommen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |