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 함수는 Size, Type, TargetDeviceName, DesiredAccess, CreateOptions및 지정된 WDF_IO_TARGET_OPEN_PARAMS 구조체의 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_INIT_CREATE_BY_NAME