EVT_WDF_DEVICE_FILE_CREATE 콜백 함수(wdfdevice.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtDeviceFileCreate 콜백 함수는 애플리케이션이 디바이스에 대한 액세스를 요청할 때 수행해야 하는 작업을 처리합니다.
구문
EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;
void EvtWdfDeviceFileCreate(
[in] WDFDEVICE Device,
[in] WDFREQUEST Request,
[in] WDFFILEOBJECT FileObject
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] Request
파일 만들기 요청을 나타내는 프레임워크 요청 개체에 대한 핸들입니다.
[in] FileObject
지정된 요청에 대해 열려 있는 파일을 설명하는 프레임워크 파일 개체에 대한 핸들입니다. 드라이버가 WDF_FILEOBJECT_CONFIG 구조체의 FileObjectClass 멤버에 대해 WdfFileObjectNotRequired를 지정한 경우 이 매개 변수는 NULL입니다.
반환 값
없음
설명
프레임워크는 사용자 애플리케이션 또는 다른 드라이버가 파일을 읽거나 쓰는 것과 같은 I/O 작업을 수행하기 위해 디바이스를 열 때 드라이버의 EvtDeviceFileCreate 콜백 함수를 호출합니다.
드라이버는 요청 핸들을 WdfRequestGetParameters 에 전달하여 파일 만들기 요청과 연결된 매개 변수를 검색할 수 있습니다. 매개 변수는 WDF_REQUEST_PARAMETERS 구조체의 Parameters.Create 멤버에 저장됩니다.
이 콜백 함수는 디바이스를 여는 스레드의 컨텍스트에서 동기적으로 호출됩니다.
EvtDeviceFileCreate 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetFileObjectConfig 메서드를 호출해야 합니다.
드라이버는 요청을 완료하거나 WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET 함께 보내야 합니다.
또는 드라이버가 큐에서 만들기 요청을 받을 수 있습니다. 자세한 내용은 WdfDeviceConfigureRequestDispatching을 참조하세요.
프레임워크 파일 개체 및 EvtDeviceFileCreate 콜백 함수에 대한 자세한 내용은 프레임워크 파일 개체를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfdevice.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL |