KsQueryInformationFile-Funktion (ks.h)

Artikel
02/29/2024

Die KsQueryInformationFile-Funktion führt eine Informationsabfrage für das angegebene Dateiobjekt aus. Die Funktion versucht, FastIoDispatch nach Möglichkeit zu verwenden, oder sie generiert eine Informationsanforderung für das Geräteobjekt.

Syntax

KSDDKAPI NTSTATUS KsQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Parameter

[in] FileObject

Gibt das Dateiobjekt an, von dem die Standardinformationen abfragt werden sollen.

[out] FileInformation

Gibt den Ort an, an dem die Dateiinformationen abgelegt werden sollen. Es wird davon ausgegangen, dass es sich um eine gültige oder überprüfte Adresse handelt.

[in] Length

Gibt die richtige Länge des FileInformation-Puffers an.

[in] FileInformationClass

Gibt die Klasse der angeforderten Informationen an.

Rückgabewert

Die KsQueryInformationFile-Funktion gibt STATUS_SUCCESS zurück, wenn dies erfolgreich war, oder wenn sie nicht erfolgreich ist, gibt sie einen Abfragefehler zurück.

Hinweise

Die KsQueryInformationFile-Funktion sollte nur in Fällen verwendet werden, in denen die Abfrage zu einer tatsächlichen Anforderung an den zugrunde liegenden Treiber führen würde. FilePositionInformation würde beispielsweise eine solche Anforderung nicht generieren und sollte nicht verwendet werden. Es wird davon ausgegangen, dass der Aufrufer den Zugriff auf die Datei für Vorgänge für ein FO_SYNCHRONOUS_IO Dateiobjekt serialisiert.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ks.h (einschließlich Ks.h)
Bibliothek	Ks.lib

Freigeben über