Google로 나누는 정

디바이스에 할당된 이름은 모두 유니코드 형태를 가지며 DeviceName에 이름을 삽입하려면 일반 문자열을 UNICODE_STRING으로 바꿔야한다. UNICODE_STRING은 구조체로, 다음 세 가지 변수를 갖고 있다.

디바이스 이름을 다음과 같이 설정한다. 모든 디바이스 이름에는 L"\\Device\\"가 붙게 된다.

UNICODE_STRING unistr_dev_name;
PCWSTR base_name = L"\\Device\\";
ULONG len;

len = uni_strlen(base_name) + uni_strlen(device_name);

unistr_dev_name.MaximumLength = static_cast((len + 1) * sizeof(WCHAR));
unistr_dev_name.Length = static_cast(len * sizeof(WCHAR));
unistr_dev_name.Buffer = new (PagedPool) WCHAR[len + 1];

if (unistr_dev_name.Buffer == NULL)
{
   nt_status = STATUS_INSUFFICIENT_RESOURCES;
   goto $exit_proc;
}

RtlZeroMemory (unistr_dev_name.Buffer, unistr_dev_name.MaximumLength);

uni_strcpy(unistr_dev_name.Buffer, base_name);
uni_strcat(unistr_dev_name.Buffer, device_name);

유저 모드 프로그램이 드라이버를 사용하려면 커널 모드 드라이버에서 유저 모드 프로그램이 드라이버를 찾을 수 있는 이름이 필요하다. 디바이스에 정확한 심볼 이름을 명시할 경우에는 심볼 이름을 생성해야 하고 그렇지 않으면 guid를 사용해 심볼로 사용할 인터페이스를 등록해야 한다. 디바이스 심볼명은 디바이스 이름과 마찬가지 방법으로 만들고 새로 등록하려면 IoCreateSymbolicLink()를 사용한다. 등록하려는 심볼과 같은 이름이 있는 경우 등록할 수 없으므로 이름짓는데 주의하기 바란다(참고로 등록된 이름을 삭제하는 함수는 IoDeleteSymbolicLink()이다).

//
// 심볼명이 주어진 심볼 등록의 예
//
NTSTATUS nt_status;
UNICODE_STRING unistr_sym_link;
PCWSTR base_win_name = L"\\DosDevices\\";
ULONG len;

len = uni_strlen(base_win_name) + uni_strlen(link_name);

unistr_sym_link.MaximumLength = static_cast((len+1) * sizeof(WCHAR));
unistr_sym_link.Length = static_cast(len * sizeof(WCHAR));
unistr_sym_link.Buffer = new (PagedPool) WCHAR[len+1];

if (unistr_sym_link.Buffer == NULL)
{
   // 메모리 해제
   return STATUS_INSUFFICIENT_RESOURCES;
}

RtlZeroMemory(unistr_sym_link.Buffer, unistr_sym_link.MaximumLength);

uni_strcpy(unistr_sym_link.Buffer, base_win_name);
uni_strcat(unistr_sym_link.Buffer, link_name);

// 심볼릭 링크 생성 요청

nt_status = IoCreateSymbolicLink (&unistr_sym_link, &unistr_dev_name);

if (! NT_SUCCESS(nt_status))
{
   // 만약 이름이 중복되는 경우

   if (nt_status == STATUS_OBJECT_NAME_COLLISION)
   {
      // 중복될 경우의 처리
   }
   return nt_status;
}

//
// 심볼명이 주어지지 않은 경우 등록의 예
//

NTSTATUS nt_status = STATUS_SUCCESS;
PUNICODE_STRING s_dev_link_name;

//
// guid 기반 심볼릭 링크를 등록한다.
//

nt_status = IoRegisterDeviceInterface (
   pdo,
   (LPGUID)p_guid,
   NULL,
   s_dev_link_name );

if (! NT_SUCCESS(nt_status))
{
   return nt_status;
}

//
// 디바이스 링크 활성화
//

nt_status = IoSetDeviceInterfaceState(s_dev_link_name, TRUE);

return nt_status;
ext->top_of_stack_device_object = IoAttachDeviceToDeviceStack (fdo, pdo)

메이저 펑션과 마이너 펑션IRP Major Function은 '무엇을 한다'에 해당하는 부분으로, 디바이스가 작동하는 큰 맥락을 이룬다. 각 Major Function은 사용할 것에 한해 각 실행 함수(Dispatch Function)가 배당되어야 하며 세부 동작은 각 Marjor Function에 딸린 Minor Function을 참조해야 한다(드라이버 제작에 필요한 몇 가지 Major Function은 앞에서 설명되었다). 디스패치 함수의 프로토타입은 다음과 같다.