IRP_MJ_QUERY_INFORMATION
Treiber können optional eine IRP_MJ_QUERY_INFORMATION-Anforderung verarbeiten.
Sendebedingungen
Das Betriebssystem sendet eine IRP_MJ_QUERY_INFORMATION Anforderung zum Abrufen von Metadaten zu einer Datei oder einem Dateihandle. Wenn ein Treiber beispielsweise ZwQueryInformationFile aufruft, sendet das Betriebssystem eine IRP_MJ_QUERY_INFORMATION Anforderung.
Eingabeparameter
Das Parameters.QueryFile.FileInformationClass-Element ist eine FILE_INFORMATION_CLASS Konstante, die den Typ der bereitzustellenden Metadaten angibt. Weitere Informationen zu den Metadatentypen finden Sie im FileInformationClass-Parameter der ZwQueryInformationFile-Routine .
Das Parameters.QueryFile.Length-Element gibt die Länge des Puffers an, auf den das AssociatedIrp.SystemBuffer-Element verweist.
Ausgabeparameter
Das AssociatedIrp.SystemBuffer-Element zeigt auf den Puffer, in dem der Treiber die angeforderten Informationen bereitstellt. Der Wert von Parameters.QueryFile.FileInformationClass bestimmt das Format der zurückzugebenden Metadaten (eine FILE_XXX_INFORMATION-Struktur ). Weitere Informationen zu den Metadatenformaten finden Sie in der FILE_INFORMATION_CLASS-Enumeration .
Vorgang
Treiber sind nicht erforderlich, um diese Anforderung zu verarbeiten, und Treiber, die nicht erforderlich sind, um jeden möglichen Wert von Parameters.QueryFile.FileInformationClass zu verarbeiten. Die Dispatchroutine des Treibers sollte einen Fehlercode wie STATUS_INVALID_DEVICE_REQUEST für alle Werte zurückgeben, die nicht verarbeitet werden.
Nicht alle möglichen Werte von FILE_INFORMATION_CLASS können auftreten.
Anforderungen
Header |
Wdm.h (einschließlich Wdm.h, Ntddk.h oder Ntifs.h) |