PFLT_NORMALIZE_NAME_COMPONENT回呼函式（fltkernel.h）

發行項
02/06/2025

提供篩選管理員名稱快取檔名的迷你篩選驅動程式，可以將類型為 PFLT_NORMALIZE_NAME_COMPONENT 的例程註冊為迷你篩選驅動程式的 NormalizeNameComponentCallback 例程。

語法

PFLT_NORMALIZE_NAME_COMPONENT PfltNormalizeNameComponent;

NTSTATUS PfltNormalizeNameComponent(
  [in]      PFLT_INSTANCE Instance,
  [in]      PCUNICODE_STRING ParentDirectory,
  [in]      USHORT VolumeNameLength,
  [in]      PCUNICODE_STRING Component,
  [out]     PFILE_NAMES_INFORMATION ExpandComponentName,
  [in]      ULONG ExpandComponentNameLength,
  [in]      FLT_NORMALIZE_NAME_FLAGS Flags,
  [in, out] PVOID *NormalizationContext
)
{...}

參數

[in] Instance

這個回呼例程已註冊之迷你篩選驅動程序實例的不透明實例指標。

[in] ParentDirectory

UNICODE_STRING 結構的指標，其中包含這個名稱元件的父目錄名稱。

[in] VolumeNameLength

ParentDirectory 參數所指向之結構中儲存之父目錄名稱的長度，以位元組為單位。

[in] Component

包含要展開之名稱元件之UNICODE_STRING結構的指標。

[out] ExpandComponentName

FILE_NAMES_INFORMATION 結構的指標，這個結構會接收名稱元件已展開的（正規化）檔名資訊。

[in] ExpandComponentNameLength

ExpandComponentName 參數指向的緩衝區長度，以位元組為單位。

[in] Flags

名稱正規化旗標。 FLTFL_NORMALIZE_NAME_CASE_SENSITIVE指定要正規化的名稱區分大小寫。 FLTFL_NORMALIZE_NAME_DESTINATION_FILE_NAME指定呼叫回呼例程來服務 FltGetDestinationFileNameInformation 例程呼叫。

[in, out] NormalizationContext

要傳遞至此回呼例程的任何後續呼叫中要傳遞的迷你篩選驅動程式提供內容資訊的指標，這些呼叫會讓相同檔名路徑中的其餘元件正規化。

傳回值

此回呼例程會傳回STATUS_SUCCESS或適當的NTSTATUS值。如果 Component 參數所指定的名稱元件不存在於父目錄中，ParentDirectory 參數所指定，則此回呼例程應該會傳回STATUS_NO_SUCH_FILE。如果這個回呼例程對父目錄發出IRP_MN_QUERY_DIRECTORY （FileNamesInformation）要求，則文件系統會傳回正確的狀態代碼。在此情況下，此回呼可以直接傳回檔系統傳回的狀態代碼。

言論

若要註冊此回呼例程，迷你篩選驅動程式會將類型PFLT_NORMALIZE_NAME_COMPONENT的例程位址儲存在 NormalizeNameComponentCallback 中FLT_REGISTRATION 結構的成員，而迷你篩選驅動程式會作為參數傳遞給 FltRegisterFilter。

篩選管理員會呼叫這個回呼例程來查詢迷你篩選驅動程式，以查詢檔名路徑中已修改迷你篩選驅動程式名稱之元件的標準化名稱。如果檔名路徑包含多個這類元件，篩選管理員可以在將路徑中的所有元件正規化的過程中多次呼叫此回呼例程。迷你篩選驅動程式可以使用 NormalizationContext 參數，將內容資訊傳遞至這個回呼例程的後續呼叫。

如果迷你篩選驅動程式使用 NormalizationContext 參數，它也應該註冊正規化內容清除回呼例程。如需詳細資訊，請參閱 PFLT_NORMALIZE_CONTEXT_CLEANUP的參考專案。