PFLT_CONNECT_NOTIFY 콜백 함수(fltkernel.h)

아티클
07/16/2024

FltMgr 미니 필터의 ConnectNotifyCallback 콜백 함수를 호출하여 통신 포트에 대한 새 연결을 요청할 때 미니 필터에 알립니다.

통사론

PFLT_CONNECT_NOTIFY PfltConnectNotify;

NTSTATUS PfltConnectNotify(
  PFLT_PORT ClientPort,
  PVOID ServerPortCookie,
  PVOID ConnectionContext,
  ULONG SizeOfContext,
  PVOID *ConnectionPortCookie
)
{...}

매개 변수

ClientPort

[in] 불투명한 FltMgr은 사용자 모드 애플리케이션과 커널 모드 미니 필터 간에 설정되는 새 클라이언트 포트에 대해 생성된 핸들을.

미니 필터는 이 클라이언트 포트에서 메시지를 보내고 회신할 때 fltSendMessage ClientPort 매개 변수로 이 핸들을 전달해야 합니다.

미니 필터는 결국 FltCloseClientPort 호출하여 일반적으로 DisconnectNotifyCallback 루틴에서 이 클라이언트 포트를 닫아야 합니다.

ClientPortFltCreateCommunicationPortServerPort 핸들 반환과 동일하지 않습니다.

ServerPortCookie

[in] 미니 필터에서 정의한 컨텍스트 정보에 대한 포인터입니다. 미니 필터는 이 정보를 사용하여 만들 수 있는 여러 통신 서버 포트를 구분할 수 있습니다. 서버 포트를 만들 때 미니 필터 드라이버는 이 컨텍스트 포인터를 ServerPortCookie 매개 변수로 전달하여 FltCreateCommunicationPort.

ConnectionContext

[in] lpContext 매개 변수에 전달된 사용자 모드 애플리케이션이 FilterConnectCommunicationPort컨텍스트 정보 포인터입니다.

SizeOfContext

[in] ConnectionContext 가리키는 버퍼의 크기(바이트)입니다.

ConnectionPortCookie

[out] 이 클라이언트 포트를 고유하게 식별하는 미니포트의 정보에 대한 포인터입니다. 미니 필터는 FltMgrMessageNotifyCallbackDisconnectNotifyCallback대한 후속 호출에서 전달될 때 연결을 식별하기 위해 이 쿠키를 사용할 수 있습니다.

반환 값

ConnectNotifyCallback 작업이 성공하고 연결이 수락되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음과 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	의미
STATUS_INSUFFICIENT_RESOURCES	작업을 완료하는 데 충분한 리소스가 없습니다.
STATUS_INVALID_PARAMETER	하나 이상의 입력 매개 변수가 잘못되었습니다.