message.c File Reference

#include <windef.h>
#include <winbase.h>
#include <ndk/iofuncs.h>
#include <ndk/obfuncs.h>
#include <ndk/rtlfuncs.h>
#include <fltuser.h>
#include <fltmgr_shared.h>
#include "fltlib.h"

Include dependency graph for message.c:

Go to the source code of this file.

Macros
#define	WIN32_NO_STATUS
#define	NTOS_MODE_USER

Functions
_Must_inspect_result_ HRESULT WINAPI	FilterConnectCommunicationPort (_In_ LPCWSTR lpPortName, _In_ DWORD dwOptions, _In_reads_bytes_opt_(wSizeOfContext) LPCVOID lpContext, _In_ WORD wSizeOfContext, _In_opt_ LPSECURITY_ATTRIBUTES lpSecurityAttributes, _Outptr_ HANDLE *hPort)
_Must_inspect_result_ HRESULT WINAPI	FilterSendMessage (_In_ HANDLE hPort, _In_reads_bytes_(dwInBufferSize) LPVOID lpInBuffer, _In_ DWORD dwInBufferSize, _Out_writes_bytes_to_opt_(dwOutBufferSize, *lpBytesReturned) LPVOID lpOutBuffer, _In_ DWORD dwOutBufferSize, _Out_ LPDWORD lpBytesReturned)
_Must_inspect_result_ HRESULT WINAPI	FilterGetMessage (_In_ HANDLE hPort, _Out_writes_bytes_(dwMessageBufferSize) PFILTER_MESSAGE_HEADER lpMessageBuffer, _In_ DWORD dwMessageBufferSize, _Inout_opt_ LPOVERLAPPED lpOverlapped)
_Must_inspect_result_ HRESULT WINAPI	FilterReplyMessage (_In_ HANDLE hPort, _In_reads_bytes_(dwReplyBufferSize) PFILTER_REPLY_HEADER lpReplyBuffer, _In_ DWORD dwReplyBufferSize)

Macro Definition Documentation

NTOS_MODE_USER

#define NTOS_MODE_USER

Definition at line 13 of file message.c.

WIN32_NO_STATUS

#define WIN32_NO_STATUS

Definition at line 9 of file message.c.

Function Documentation

FilterConnectCommunicationPort()

_Must_inspect_result_ HRESULT WINAPI FilterConnectCommunicationPort	(	_In_ LPCWSTR	lpPortName,
		_In_ DWORD	dwOptions,
		_In_reads_bytes_opt_(wSizeOfContext) LPCVOID	lpContext,
		_In_ WORD	wSizeOfContext,
		_In_opt_ LPSECURITY_ATTRIBUTES	lpSecurityAttributes,
		_Outptr_ HANDLE *	hPort
	)

Definition at line 25 of file message.c.

{
    OBJECT_ATTRIBUTES ObjectAttributes;
    IO_STATUS_BLOCK IoStatusBlock;
    PFILTER_PORT_DATA PortData;
    UNICODE_STRING DeviceName;
    UNICODE_STRING PortName;
    HANDLE FileHandle;
    SIZE_T PortNameSize;
    SIZE_T BufferSize;
    PCHAR Ptr;
    NTSTATUS Status;
    HRESULT hr;
 
    *hPort = INVALID_HANDLE_VALUE;
 
    /* Sanity check */
    if (lpContext && wSizeOfContext == 0)
    {
        return E_INVALIDARG;
    }
 
    /* Get the length of the port name */
    PortNameSize = wcslen(lpPortName) * sizeof(WCHAR);
 
    /* Calculate and allocate the size of the required buffer */
    BufferSize = sizeof(FILTER_PORT_DATA) + PortNameSize + wSizeOfContext;
    PortData = RtlAllocateHeap(GetProcessHeap(), 0, BufferSize);
    if (PortData == NULL) return E_OUTOFMEMORY;
 
    /* Clear out the buffer and find the end of the fixed struct */
    RtlZeroMemory(PortData, BufferSize);
    Ptr = (PCHAR)(PortData + 1);
 
    PortData->Size = BufferSize;
    PortData->Options = dwOptions;
 
    /* Setup the port name */
    RtlInitUnicodeString(&PortName, lpPortName);
    PortData->PortName.Buffer = (PWCH)Ptr;
    PortData->PortName.MaximumLength = PortNameSize;
    RtlCopyUnicodeString(&PortData->PortName, &PortName);
    Ptr += PortData->PortName.Length;
 
    /* Check if we were given a context */
    if (lpContext)
    {
        /* Add that into the buffer too */
        PortData->Context = Ptr;
        RtlCopyMemory(PortData->Context, lpContext, wSizeOfContext);
    }
 
    /* Initialize the object attributes */
    RtlInitUnicodeString(&DeviceName, L"\\Global??\\FltMgrMsg");
    InitializeObjectAttributes(&ObjectAttributes,
                               &DeviceName,
                               OBJ_EXCLUSIVE | OBJ_CASE_INSENSITIVE,
                               NULL,
                               NULL);
 
    /* Check if we were passed any security attributes */
    if (lpSecurityAttributes)
    {
        /* Add these manually and update the flags if we were asked to make it inheritable */
        ObjectAttributes.SecurityDescriptor = lpSecurityAttributes->lpSecurityDescriptor;
        if (lpSecurityAttributes->bInheritHandle)
        {
            ObjectAttributes.Attributes |= OBJ_INHERIT;
        }
    }
 
    /* Now get a handle to the device */
    Status = NtCreateFile(&FileHandle,
                          SYNCHRONIZE | FILE_READ_DATA | FILE_WRITE_DATA,
                          &ObjectAttributes,
                          &IoStatusBlock,
                          0,
                          0,
                          0,
                          FILE_OPEN_IF,
                          0,
                          PortData,
                          BufferSize);
    if (NT_SUCCESS(Status))
    {
        *hPort = FileHandle;
        hr = S_OK;
    }
    else
    {
        hr = NtStatusToHResult(Status);
    }
 
    /* Cleanup and return */
    RtlFreeHeap(GetProcessHeap(), 0, PortData);
    return hr;
}

Referenced by KmtFltConnect().

FilterGetMessage()

_Must_inspect_result_ HRESULT WINAPI FilterGetMessage	(	_In_ HANDLE	hPort,
		_Out_writes_bytes_(dwMessageBufferSize) PFILTER_MESSAGE_HEADER	lpMessageBuffer,
		_In_ DWORD	dwMessageBufferSize,
		_Inout_opt_ LPOVERLAPPED	lpOverlapped
	)

Definition at line 150 of file message.c.

{
    UNREFERENCED_PARAMETER(hPort);
    UNREFERENCED_PARAMETER(lpMessageBuffer);
    UNREFERENCED_PARAMETER(dwMessageBufferSize);
    UNREFERENCED_PARAMETER(lpOverlapped);
    return E_NOTIMPL;
}

Referenced by KmtFltGetMessage().

FilterReplyMessage()

_Must_inspect_result_ HRESULT WINAPI FilterReplyMessage	(	_In_ HANDLE	hPort,
		_In_reads_bytes_(dwReplyBufferSize) PFILTER_REPLY_HEADER	lpReplyBuffer,
		_In_ DWORD	dwReplyBufferSize
	)

Definition at line 165 of file message.c.

{
    UNREFERENCED_PARAMETER(hPort);
    UNREFERENCED_PARAMETER(lpReplyBuffer);
    UNREFERENCED_PARAMETER(dwReplyBufferSize);
    return E_NOTIMPL;
}

Referenced by KmtFltReplyMessage().

FilterSendMessage()

_Must_inspect_result_ HRESULT WINAPI FilterSendMessage	(	_In_ HANDLE	hPort,
		_In_reads_bytes_(dwInBufferSize) LPVOID	lpInBuffer,
		_In_ DWORD	dwInBufferSize,
		_Out_writes_bytes_to_opt_(dwOutBufferSize, *lpBytesReturned) LPVOID	lpOutBuffer,
		_In_ DWORD	dwOutBufferSize,
		_Out_ LPDWORD	lpBytesReturned
	)

Definition at line 131 of file message.c.

{
    UNREFERENCED_PARAMETER(hPort);
    UNREFERENCED_PARAMETER(lpInBuffer);
    UNREFERENCED_PARAMETER(dwInBufferSize);
    UNREFERENCED_PARAMETER(lpOutBuffer);
    UNREFERENCED_PARAMETER(dwOutBufferSize);
    UNREFERENCED_PARAMETER(lpBytesReturned);
    return E_NOTIMPL;
}

Referenced by KmtFltSendMessage().