PFLT_CONNECT_NOTIFY回呼函式 (fltkernel.h)
FltMgr 呼叫小型篩選程式的 ConnectNotifyCallback 回呼函式,以在要求與通訊埠的新連線時通知迷你篩選程式。
語法
PFLT_CONNECT_NOTIFY PfltConnectNotify;
NTSTATUS PfltConnectNotify(
PFLT_PORT ClientPort,
PVOID ServerPortCookie,
PVOID ConnectionContext,
ULONG SizeOfContext,
PVOID *ConnectionPortCookie
)
{...}
參數
ClientPort
[in]不透明,FltMgr-generated handle for the new client port that is established between the user-mode application and the kernel-mode minifilter.
迷你篩選程式必須在傳送和回復此用戶端埠上的訊息時,將此句柄當做 ClientPort 參數傳遞至 FltSendMessage。
迷你篩選程式最終必須呼叫 FltCloseClientPort 關閉此用戶端埠,通常是從其 DisconnectNotifyCallback 例程。
ClientPort 與FltCreateCommunicationPort所傳回的 ServerPort 句柄不同。
ServerPortCookie
[in]迷你篩選所定義之內容資訊的指標。 迷你篩選工具可以使用這項資訊來區分它可能建立的多個通訊伺服器埠。 建立伺服器埠時,迷你篩選驅動程式會將此內容指標當做 ServerPortCookie 參數傳遞至 FltCreateCommunicationPort。
ConnectionContext
[in]使用者模式應用程式在 lpContext 參數中傳遞至 filterConnectCommunicationPort的內容資訊指標。
SizeOfContext
[in]ConnectionContext 指向的緩衝區大小,以位元組為單位。
ConnectionPortCookie
[out]可唯一識別此用戶端埠之迷你埠資訊的指標。 小型篩選程式可以使用此 Cookie 來識別連線時,FltMgr 在後續 呼叫中傳遞至 messageNotifyCallback,DisconnectNotifyCallback。
傳回值
如果作業成功且已接受連線,ConnectNotifyCallback 會傳回STATUS_SUCCESS。 否則,它會傳回適當的NTSTATUS值,例如:
傳回碼 | 意義 |
---|---|
STATUS_INSUFFICIENT_RESOURCES | 沒有足夠的資源來完成作業。 |
STATUS_INVALID_PARAMETER | 一或多個輸入參數無效。 |
言論
每當使用者模式應用程式呼叫 filterConnectCommunicationPort 將連線要求傳送至迷你篩選驅動程式時,FltMgr 呼叫此例程。
迷你篩選程式應該執行連線嘗試的任何必要驗證。
如需詳細資訊,請參閱 使用者模式與迷你篩選之間的通訊。
要求
要求 | 價值 |
---|---|
標頭 | fltkernel.h |
連結庫 | FltMgr.lib |
DLL | FltMgr.sys |
IRQL | PASSIVE_LEVEL |