PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK回呼函式（ntifs.h）

發行項
12/21/2024

篩選驅動程式可以將PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK類型的例程註冊為篩選驅動程式的 CleanupCallback 回呼例程，以用於額外的建立參數（ECP）內容結構。

語法

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

參數

[in, out] EcpContext

由配置 ECP 內容結構的例程所傳回的 ECP 內容指標。

[in[] EcpType

傳遞至配置 ECP 內容結構的例程之 GUID 指標，表示額外的建立參數類型。如需詳細資訊，請參閱在驅動程式中使用 GUID 。

傳回值

沒有

言論

當篩選驅動程式配置 ECP 內容結構時，可以選擇性地指定PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK類型的例程做為篩選驅動程式的 CleanupCallback 回呼例程。如果篩選驅動程式指定 CleanupCallback 回呼例程，則操作系統會叫用 CleanupCallback 例程（不論 IRQ 層級為何）。此 CleanupCallback 例程會在刪除 ECP 內容結構時執行任何必要的 ECP 內容相關清除處理。

若要指定回呼例程，篩選驅動程式會使用原本配置 ECP 內容結構的例程 CleanupCallback 參數，將指標傳遞至回呼例程。如果不需要回呼例程，則必須將 NULL 值傳遞給 CleanupCallback 參數。

下列例程支援PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK類型的回呼例程：