KsQueryInformationFile-Funktion (ks.h)

Artikel
02/07/2025

Die KsQueryInformationFile--Funktion führt eine Informationsabfrage für das angegebene Dateiobjekt aus. Die Funktion versucht, FastIoDispatch nach Möglichkeit zu verwenden, oder es 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 die Stelle an, an der die Dateiinformationen abgelegt werden sollen. Es wird davon ausgegangen, dass es sich um eine gültige oder abgesondete 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 die Funktion erfolgreich verläuft, oder wenn die Funktion nicht erfolgreich ist, wird ein Abfragefehler zurückgegeben.

Bemerkungen

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. Beispielsweise würde FilePositionInformation 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-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Freigeben über