PFLT_CONTEXT_ALLOCATE_CALLBACK回呼函式（fltkernel.h）

發行項
02/06/2025

小型篩選驅動程式可以將類型為 PFLT_CONTEXT_ALLOCATE_CALLBACK 的例程註冊為迷你篩選驅動程式的 ContextAllocateCallback 例程。

語法

PFLT_CONTEXT_ALLOCATE_CALLBACK PfltContextAllocateCallback;

PVOID PfltContextAllocateCallback(
  [in] POOL_TYPE PoolType,
  [in] SIZE_T Size,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

參數

[in] PoolType

要配置的集區類型。這是必要參數，而且必須是下列其中一項：

NonPagedPool

PagedPool

如果 ContextType 參數FLT_VOLUME_CONTEXT，則必須 NonPagedPool。

[in] Size

整個內容的大小，以位元組為單位，包括篩選管理員所定義的部分，以及迷你篩選驅動程式所定義的部分。

[in] ContextType

內容的類型。此參數是必要的，而且必須是下列其中一個值：

FLT_FILE_CONTEXT （從 Windows Vista 開始）

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT （從 Windows 8 開始）

FLT_TRANSACTION_CONTEXT （從 Windows Vista 開始）

FLT_VOLUME_CONTEXT

傳回值

如果沒有足夠的可用集區來滿足要求，此例程會傳回 NULL 指標。否則，它會傳回新配置內容的指標。

言論

針對小型篩選驅動程式必須執行自己的內容配置的罕見情況，它可以指定類型為 PFLT_CONTEXT_ALLOCATE_CALLBACK 類型的例程，做為 ContextAllocateCallback 例程，當它呼叫 FltRegisterFilter 時，它會從其 DriverEntry 例程中註冊的每個內容類型指定例程。若要指定此例程，迷你篩選驅動程式會將例程的指標儲存在內容類型的 ContextAllocateCallback 成員FLT_CONTEXT_REGISTRATION結構中。

如需內容註冊的詳細資訊，請參閱 FLT_CONTEXT_REGISTRATION的參考專案。