FltRetrieveFileInfoOnCreateCompletionEx-Funktion (fltkernel.h)

FltRetrieveFileInfoOnCreateCompletionEx Abfragen der angegebenen Dateiinformationen nach Abschluss der Dateierstellung.

Syntax

NTSTATUS FLTAPI FltRetrieveFileInfoOnCreateCompletionEx(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             RetInfoSize,
  [out] PVOID              *RetInfoBuffer
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger, der den Minifiltertreiber eindeutig identifiziert. Sie wird von FltRegisterFilterzurückgegeben und bleibt konstant, solange der Minifiltertreiber geladen wird.

[in] Data

Zeigen Sie auf die FLT_CALLBACK_DATA Rückrufdaten, die den E/A-Vorgang darstellen.

[in] InfoClass

Flag, das den Typ der zurückzugebenden Dateiinformationen angibt. Beachten Sie, dass Flags nicht kombiniert werden können. Dies kann einer der folgenden Werte sein:

[out] RetInfoSize

Zeiger auf eine ULONG, die die Größe des Puffers in Byte empfängt, auf den RetInfoBuffer verweist.

[out] RetInfoBuffer

Empfängt einen Zeiger auf die angeforderte InfoClass- Struktur. Wenn das Dateisystem die Anforderung verarbeiten kann, aber die angeforderten Dateiinformationen nicht finden kann, wird dieser Parameter auf NULL festgelegt.

Rückgabewert

Bemerkungen

FltRequestFileInfoOnCreateCompletion und FltRetrieveFileInfoOnCreateCompletionEx es einem Minifilter ermöglichen, Während der Dateierstellung Informationen zu einer Datei abzurufen, wodurch die Leistungskosten einer späteren Abfrage vermieden werden, die ein Stapel-Traversal erfordern würde.

• Im Voraus erstellt der Minifilter einen Aufruf an FltRequestFileInfoOnCreateCompletion mit einer Kombination aus Eingaben InfoClassFlags, die die angeforderten Informationen identifizieren.
• Das Dateisystem weist die entsprechende Struktur(n) zu und füllt die angeforderten Informationen, sofern unterstützt, während die Erstellung verarbeitet wird.
• Nach der Erstellung ruft der Minifilter FltRetrieveFileInfoOnCreateCompletionEx auf, um die im Voraberstellungsaufruf angeforderten Informationen abzurufen. Wenn der Minifilter mehrere Informationstypen angefordert hat, muss er FltRetrieveFileInfoOnCreateCompletionEx einmal für jeden Informationstyp aufrufen. Zum Beispiel:

// Pre-create:
NTSTATUS status;
status = FltRequestFileInfoOnCreateCompletion( Filter,
                                               CallbackData,
                                               QoCFileStatInformation
                                                | QoCFileLxInformation
                                                | QoCFileEaInformation 
                                                | QoCFileUsnInformation );

// Post-create:
NTSTATUS status;
ULONG fileStatSize, fileLxSize, fileEaSize;
QUERY_ON_CREATE_FILE_STAT_INFORMATION* fileStatInfo;
QUERY_ON_CREATE_FILE_LX_INFORMATION* fileLxInfo;
QUERY_ON_CREATE_EA_INFORMATION* fileEaInfo;
QUERY_ON_CREATE_USN_INFORMATION* fileUsnInfo;
QUERY_ON_CREATE_SECURITY_INFORMATION* fileSecurityInfo;

status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileStatInformation,
                                                  &fileStatSize,
                                                  &fileStatInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileLxInformation,
                                                  &fileLxSize,
                                                  &fileLxInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileEaInformation, 
                                                  &fileEaSize, 
                                                  &fileEaInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileUsnInformation, 
                                                  &fileUsnInfo, 
                                                  &fileUsnInfo );
status = FltRetrieveFileInfoOnCreateCompletionEx( Filter,
                                                  CallbackData,
                                                  QoCFileSecurityInformation,
                                                  &fileSecurityInfo,
                                                  &fileSecurityInfo);

Sobald FltRetrieveFileInfoOnCreateCompletionEx- zurückgegeben wird, kann ein Minifilter in den Puffer schreiben, auf den RetInfoBuffer verweist. Alle Filter oberhalb dieses Minifilters sehen die Änderungen, wenn sie FltRetrieveFileInfoOnCreateCompletionEx für den geänderten Informationstyp aufrufen.

Anforderungen

Siehe auch

ECP_LIST

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion-

QUERY_ON_CREATE_EA_INFORMATION

QUERY_ON_CREATE_FILE_STAT_INFORMATION

QUERY_ON_CREATE_FILE_LX_INFORMATION