PFLT_CONTEXT_ALLOCATE_CALLBACK回呼函式 (fltkernel.h)

發行項
02/29/2024

迷你篩選驅動程式可以註冊類型為 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

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

從 Windows Vista) 開始FLT_FILE_CONTEXT (

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

從 Windows 8) 開始FLT_SECTION_CONTEXT (

從 Windows Vista) 開始FLT_TRANSACTION_CONTEXT (

FLT_VOLUME_CONTEXT

傳回值

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

備註

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

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