FilterSendMessage 函式 (fltuser.h)
FilterSendMessage函式會將訊息傳送至核心模式迷你篩選程式。
語法
HRESULT FilterSendMessage(
[in] HANDLE hPort,
[in, optional] LPVOID lpInBuffer,
[in] DWORD dwInBufferSize,
[out] LPVOID lpOutBuffer,
[in] DWORD dwOutBufferSize,
[out] LPDWORD lpBytesReturned
);
參數
[in] hPort
先前呼叫 FilterConnectCommunicationPort所傳回的通訊埠控制碼。 這個參數是必要的，而且不能是 Null。
[in, optional] lpInBuffer
呼叫端配置的緩衝區指標，其中包含要傳送至迷你篩選器的訊息。 訊息格式是呼叫端定義的。 這個參數是必要的，而且不能是 Null。
[in] dwInBufferSize
lpInBuffer所指向之緩衝區的大小，以位元組為單位。
[out] lpOutBuffer
呼叫端配置的緩衝區指標，如果來自迷你篩選器的任何) ，則接收回複 (。
[in] dwOutBufferSize
lpOutBuffer所指向緩衝區的大小，以位元組為單位。 如果 lpOutBuffer 為 Null，則會忽略此值。
[out] lpBytesReturned
呼叫端配置的變數指標，這個變數會接收 lpOutBuffer 在緩衝區中傳回的位元組數目，如果 FilterSendMessage 的呼叫成功，則會指向該變數。 這個參數是必要的，而且不能是 Null。
傳回值
如果成功，FilterSendMessage會傳回S_OK。 否則，它會傳回錯誤值。
備註
FilterSendMessage函式會將訊息傳送至迷你篩選程式。 訊息會傳遞至迷你篩選程式的訊息通知回呼常式，此常式會處理訊息。 (迷你篩選程式會將訊息回呼通知常式傳遞為 MessageNotifyCallback 參數傳遞至 FltCreateCommunicationPort.)
FilterSendMessage 是同步的。 當收到任何) 時，呼叫端會進入等候狀態，直到訊息傳遞且迷你篩選器的回復 (為止。
如果呼叫端需要回復，它必須傳遞 lpOutBuffer 參數的非Null緩衝區，以及dwOutBufferSize參數的正值。
若要從迷你篩選器取得訊息，請呼叫 FilterGetMessage。
若要回復來自迷你篩選的訊息，請呼叫 FilterReplyMessage。
迷你篩選程式會呼叫 FltSendMessage，將訊息傳送至使用者模式應用程式。
需求
| 目標平台 | Universal |
| 標頭 | fltuser.h (包含 Fltuser.h) |
| 程式庫 | FltLib.lib |
| Dll | FltLib.dll |