IOCTL_PF_SET_EXTENSION

IOCTL_PF_SET_EXTENSION_POINTER

필터-훅 드라이버는 필터-훅 드라이버가 IP 필터 드라이버에 제출하는 IRP를 설정하기 위해서 이 IOCTL을 사용한다. 필터-훅 드라이버는 IRP를 설정하기 위해서 IoBuildDeviceIoControlRequest 함수에 있는 연관된 파라미터들과 함께 IOCTL을 통과시킨다.

연산

IOCTL_PF_SET_EXTENSION_POINTER 는 수신되고 전송된 모든 IP 패킷에 대한 그들 필터 훅 콜백들을 호출하기위해서 IP 필터 드라이버에게 알리기 위해서 IP 필터 드라이버에 대한 필터 훅 콜백 함수들을 등록한다.(??) 또한, IOCTL_PF_SET_EXTENSION_POINTER 는 IP 필터 드라이버로부터 필터 훅 콜백 함수들을 지운다.(clear)

매개변수

IoControlCode: IOCTL_PF_SET_EXTENSION_POINTER.
DeviceObject: IP 필터 드라이버를 위한 장치 오브젝트에 대한 포인터.
InputBuffer: PF_SET_EXTENSION_HOOK_INFO 구조체를 포함하는 위치에 대한 포인터. 필터 훅 콜백 함수르 등록하기 위해서, 이 구조체는 필터 훅 콜백 함수의 주소를 보유한다.(hold) 필터 훅 콜백 함수를 지우기 위해서, 이 구조체는 NULL 값을 보유한다.
InputBufferLength: PF_SET_EXTENSION_HOOK_INFO 구조체의 바이트 크기.
OutputBuffer: NULL.
OutputBufferLength: Zero.
InternalDeviceIoControl: FALSE.
Event: NULL.
IoStatusBlock: I/O 상태 블럭(status block)을 수신하기 위한 위치에 대한 포인터. I/O 상태는 IP 필터 드라이버가 I/O 요청을 완성한 후에 설정한다.

주석

IRP를 설정하기 위해서, 필터-훅 드라이버는 IoBuildDeviceIoControlRequest 함수를 호출한다. 이 호출에서, 필터-훅 드라이버는 IOCTL_PF_SET_EXTENSION_POINTER 요청을 지정하는 파라미터를 통과시킨다.; IP 필터 드라이버에 대한 장치 오브젝트에 대한 포인터; 그리고 PF_SET_EXTENSION_HOOK_INFO 구조체를 포함하는 입력 버퍼. IP 필터 드라이버에 대한 장치 오브젝트를 회수하기 위해서, 필터-훅 드라이버는 IoGetDeviceObjectPointer 함수를 호출한다. 이 호출에서, 필터-훅 드라이버는 IP 필터 드라이버에 대한 장치 오브젝트의 이름을 지정하는 파라미터들을 SYNCHRONIZE, GENERIC_READ, 그리고 GENERIC_WRITE 와 함께 통과시킨다. 이 값든은 제공된 드라이버에게 synchronous, read, 그리고 write 접근을 지정한다. IoGetDeviceObjectPointer 호출에서, 필터-훅 드라이버는 또한 IP 필터 드라이버에 대한 리턴된 파일과 장치 오브젝트들을 보유하기 위해서 버퍼들에 대한 포인터들을 통과 시킨다. IP 필터 드라이버에 대한 장치 오브젝트의 이름을 포함하는 유니코드 스트링은 \\Device\Ipfilterdriver이다.

IRP를 제출하기 위해서, 필터-훅 드라이버는 IoCallDriver 함수를 호출한다.

PF_SET_EXTENSION_HOOK_INFO 구조체는 아래의 섹션에 정의된다.

PF_SET_EXTENSION_HOOK_INFO

PF_SET_EXTENSION_HOOK_INFO 구조체는 필터-훅 콜백 함수를 설명하는 정보를 포함한다.

typedef struct _PF_SET_EXTENSION_HOOK_INFO { PacketFilterExtensionPtr ExtensionPointer; } PF_SET_EXTENSION_HOOK_INFO, *PPF_SET_EXTENSION_HOOK_INFO;

이 구조체의 멤버는 아래의 정보를 포함한다:

ExtensionPointer: IP 필터 드라이버를 가지고 함수를 등록하기 위해서 필터 훅 콜백 함수를 가리키는 PacketFilterExtensionPtr 데이터 타입을 지정한다. 만약 ExtensionPointer 가 NULL 값이면, 앞서 등록된 하수는 IP 필터 드라이버로부터 지워진다.