Función FilterConnectCommunicationPort (fltuser.h)

Artículo
08/23/2023

FilterConnectCommunicationPort abre una nueva conexión a un puerto de servidor de comunicación creado por un minifiltro del sistema de archivos.

Sintaxis

HRESULT FilterConnectCommunicationPort(
  [in]           LPCWSTR               lpPortName,
  [in]           DWORD                 dwOptions,
  [in, optional] LPCVOID               lpContext,
  [in]           WORD                  wSizeOfContext,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out]          HANDLE                *hPort
);

Parámetros

[in] lpPortName

Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre completo del puerto del servidor de comunicación (por ejemplo, L"\MyFilterPort").

[in] dwOptions

Opciones de conexión para el puerto de comunicación. Antes de Windows 8.1, este valor se establece en 0.

Valor	Significado
FLT_PORT_FLAG_SYNC_HANDLE	El identificador devuelto en hPort es para E/S sincrónica. Esta marca está disponible a partir de Windows 8.1.

[in, optional] lpContext

Puntero a la información de contexto proporcionada por el autor de la llamada que se va a pasar a la rutina de notificación de conexión del minifiltro en modo kernel. (Consulte el parámetro ConnectNotifyCallback en la página de referencia de FltCreateCommunicationPort). Este parámetro es opcional y puede ser NULL.

[in] wSizeOfContext

Tamaño, en bytes, de la estructura a la que apunta el parámetro lpContext . Si el valor de lpContext no es NULL, este parámetro debe ser distinto de cero. Si lpContext es NULL, este parámetro debe ser cero.

[in, optional] lpSecurityAttributes

Puntero a una estructura de SECURITY_ATTRIBUTES que determina si el identificador devuelto se puede heredar de procesos secundarios. Para obtener más información sobre la estructura de SECURITY_ATTRIBUTES, consulte la documentación de Microsoft Windows SDK. Este parámetro es opcional y puede ser NULL. Si este parámetro es NULL, no se puede heredar el identificador.

[out] hPort

Puntero a una variable asignada por el autor de la llamada que recibe un identificador para el puerto de conexión recién creado si la llamada a FilterConnectCommunicationPort se realiza correctamente; de lo contrario, recibe INVALID_HANDLE_VALUE.

Valor devuelto

FilterConnectCommunicationPort devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.

Comentarios

FilterConnectCommunicationPort abre una conexión al puerto del servidor de comunicación de un minifiltro en nombre de una aplicación en modo de usuario. La aplicación usa el controlador de puerto de conexión resultante para comunicarse con el minifiltro.

Después de llamar correctamente a FilterConnectCommunicationPort, la aplicación puede enviar mensajes al minifiltro a través del puerto de conexión llamando a FilterSendMessage. También puede recibir y responder a los mensajes del minifiltro llamando a FilterGetMessage y FilterReplyMessage, respectivamente. El identificador de puerto de conexión devuelto en el parámetro hPort se pasa como primer parámetro a FilterSendMessage, FilterGetMessage y FilterReplyMessage.

Cualquier identificador que se obtenga de FilterConnectCommunicationPort debe liberarse al llamar a CloseHandle.