向篩選引擎註冊圖說文字
圖說文字驅動程式建立裝置物件之後,就可以向篩選引擎註冊其注標。 圖說文字驅動程式可以隨時向篩選引擎註冊其注標,即使篩選引擎目前未執行也一樣。 若要向篩選引擎註冊圖說文字,圖說文字驅動程式會呼叫 FwpsCalloutRegister0 函式。 例如:
// Prototypes for the callout's callout functions
VOID NTAPI
ClassifyFn(
IN const FWPS_INCOMING_VALUES0 *inFixedValues,
IN const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
IN OUT VOID *layerData,
IN const FWPS_FILTER0 *filter,
IN UINT64 flowContext,
IN OUT FWPS_CLASSIFY_OUT0 *classifyOut
);
NTSTATUS NTAPI
NotifyFn(
IN FWPS_CALLOUT_NOTIFY_TYPE notifyType,
IN const GUID *filterKey,
IN const FWPS_FILTER0 *filter
);
VOID NTAPI
FlowDeleteFn(
IN UINT16 layerId,
IN UINT32 calloutId,
IN UINT64 flowContext
);
// Callout registration structure
const FWPS_CALLOUT0 Callout =
{
{ ... }, // GUID key identifying the callout
0, // Callout-specific flags (none set here)
ClassifyFn,
NotifyFn,
FlowDeleteFn
};
// Variable for the run-time callout identifier
UINT32 CalloutId;
NTSTATUS
DriverEntry(
IN PDRIVER_OBJECT DriverObject,
IN PUNICODE_STRING RegistryPath
)
{
PDEVICE_OBJECT deviceObject;
NTSTATUS status;
...
status =
FwpsCalloutRegister0(
deviceObject,
&Callout,
&CalloutId
);
...
return status;
}
如果 呼叫 FwpsCalloutRegister0 函式成功,則最後一個參數所指向的變數會包含圖說文字的執行時間識別碼。 此執行時間識別碼會對應至為圖說文字金鑰指定的 GUID。
單一圖說文字驅動程式可以實作一個以上的圖說文字。 如果圖說文字驅動程式實作一個以上的圖說文字,它會針對支援向篩選引擎註冊每個圖說文字的每個圖說文字呼叫 FwpsCalloutRegister0 函式一次。