KsFastPropertyHandler-Funktion (ks.h)

Die KsFastPropertyHandler--Funktion verarbeitet schnelle Eigenschaftsanforderungen über IOCTL_KS_PROPERTY. Sie antwortet auf alle Eigenschaftenbezeichner, die durch die Sätze definiert sind, die auch in der schnellen E/A-Liste 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 behandelt wurde, oder FALSE-, wenn die Anforderung nicht behandelt wurde. Wenn FALSE- zurückgegeben wird, wird ein IRP generiert. Wenn die Anforderung behandelt wurde, legt die Funktion das IoStatus->Information-Element fest, entweder durch Festlegen auf Null aufgrund eines internen Fehlers oder durch festlegen eines Eigenschaftshandlers. Der Eigenschaftenhandler legt außerdem das IoStatus->Statusfeld fest, wenn die Eigenschaft tatsächlich behandelt wird.

Bemerkungen

Der Besitzer eines Eigenschaftensatzes kann Vorfilterung oder Nachfilterung der Eigenschaftenbehandlung sowie Verarbeitungsanforderungen ausführen, die über die schnelle E/A-Verteilerschnittstelle für die Gerätesteuerung vorgenommen werden. Die KsFastPropertyHandler Funktion wird nur verwendet, um Anforderungen zu verarbeiten, die schnell erfüllt werden können. Der parameter Wait der schnellen E/A-Funktion wird nicht übergeben und wird als TRUEangenommen.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Siehe auch

KsPropertyHandler-