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

추가 정보

WDF_FILEOBJECT_CONFIG