CreateFile 함수에 대한 상세 설명 (WinAPI)

CreateFile은 Windows 시스템에서 파일, 장치, 직렬 포트, 파이프, 드라이버 장치 등의 개체를 열 때 사용되는 핵심 함수입니다. 다음은 이 함수의 프로토타입입니다:

HANDLE CreateFile(
  LPCSTR                lpFileName,
  DWORD                 dwDesiredAccess,
  DWORD                 dwShareMode,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  DWORD                 dwCreationDisposition,
  DWORD                 dwFlagsAndAttributes,
  HANDLE                hTemplateFile
);

C#에서는 일반적으로 P/Invoke을 통해 호출됩니다:

[DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Auto)]
public static extern SafeFileHandle OpenDevice(
    string pathName,
    uint accessMode,
    uint shareMode,
    IntPtr securityAttrs,
    uint creationDisposition,
    uint flagsAndAttributes,
    IntPtr templateFile);

각 매개변수에 대한 상세 설명

예제: DMA 장치 열기 (권장 방법)

const uint GENERIC_READ = 0x80000000;
const uint GENERIC_WRITE = 0x40000000;
const uint OPEN_EXISTING = 3;
const uint FILE_ATTRIBUTE_NORMAL = 0x80;

SafeFileHandle deviceHandle = OpenDevice(
    @"\\.\device0",     // DMA 장치 경로
    GENERIC_READ,       // 읽기 권한 (C2H 채널)
    0,                  // 공유 없음 (독점)
    IntPtr.Zero,        // 기본 보안 속성
    OPEN_EXISTING,      // 이미 존재하는 장치 열기
    FILE_ATTRIBUTE_NORMAL,  // 표준 속성 (비동기 I/O 미사용)
    IntPtr.Zero         // 템플릿 핸들 미사용
);

매개변수 선택 시 유의사항 (특히 DMA 사용 시)

일반적인 오류 원인

추가 팁: 제어 채널 열기 (레지스터 조작)

var controlHandle = OpenDevice(
    @"\\.\control_device",
    GENERIC_READ | GENERIC_WRITE,
    0,
    IntPtr.Zero,
    OPEN_EXISTING,
    FILE_ATTRIBUTE_NORMAL,
    IntPtr.Zero);