WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 함수(wdfiotarget.h)

[KMDF 및 UMDF에 적용]

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 함수는 드라이버가 디바이스, 파일 또는 디바이스 인터페이스의 이름을 지정하여 I/O 대상을 열 수 있도록 드라이버의 WDF_IO_TARGET_OPEN_PARAMS 구조를 초기화합니다. 제공된 이름이 없으면 시스템에서 해당 이름을 만들려고 시도하지 않습니다.

구문

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in]  PCUNICODE_STRING           TargetDeviceName,
  [in]  ACCESS_MASK                DesiredAccess
);

매개 변수

[out] Params

함수가 초기화하는 드라이버 할당 WDF_IO_TARGET_OPEN_PARAMS 구조체에 대한 포인터입니다.

[in] TargetDeviceName

WDF_IO_TARGET_OPEN_PARAMS 구조체의 TargetDeviceName 멤버에 대한 값입니다.

[in] DesiredAccess

WDF_IO_TARGET_OPEN_PARAMS 구조체의 DesiredAccess 멤버에 대한 값입니다.

반환 값

없음

설명

TargetDeviceName이 이미 존재하는 파일의 이름을 지정하면 시스템에서 기존 파일을 엽니다. 파일이 없으면 열린 작업이 실패합니다.

WDF_IO_TARGET_OPEN_PARAMS 구조체는 WdfIoTargetOpen 메서드에 대한 입력으로 사용됩니다.

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 함수는 지정된 WDF_IO_TARGET_OPEN_PARAMS 구조체의 Size, Type, TargetDeviceName, DesiredAccess, CreateOptions 및 CreateDisposition 멤버를 초기화합니다.

Kmdf WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 함수는 CreateDisposition 멤버를 FILE_OPEN 초기화합니다.

Umdf WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 함수는 CreateDisposition 멤버를 OPEN_EXISTING 초기화합니다.

I/O 대상에 대한 자세한 내용은 I/O 대상 사용을 참조하세요.

예제

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME 사용하는 코드 예제는 WdfIoTargetOpen을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfiotarget.h(Wdf.h 포함)
IRQL	모든 수준

추가 정보

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen