EVT_WDF_IO_QUEUE_IO_WRITE 콜백 함수(wdfio.h)
[KMDF 및 UMDF에 적용]
드라이버의 EvtIoWrite 이벤트 콜백 함수는 지정된 쓰기 요청을 처리합니다.
구문
EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;
void EvtWdfIoQueueIoWrite(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
매개 변수
[in] Queue
I/O 요청과 연결된 프레임워크 큐 개체에 대한 핸들입니다.
[in] Request
프레임워크 요청 개체에 대한 핸들입니다.
[in] Length
쓸 바이트 수 입니다.
반환 값
없음
설명
드라이버가 WdfIoQueueCreate를 호출할 때 EvtIoWrite 콜백 함수를 등록합니다. WdfIoQueueCreate를 호출하는 방법에 대한 자세한 내용은 I/O 큐 만들기를 참조하세요.
드라이버가 디바이스의 I/O 큐에 대해 EvtIoWrite 콜백 함수를 등록한 경우 콜백 함수는 큐에서 모든 쓰기 요청을 수신합니다. 자세한 내용은 요청 처리기를 참조하세요.
EvtIoWrite 콜백 함수는 수신된 각 I/O 요청을 어떤 방식으로 처리해야 합니다. 자세한 내용은 I/O 요청 처리를 참조하세요.
쓰기 요청에는 드라이버가 수신하는 데이터가 포함된 입력 버퍼가 필요합니다. 드라이버가 쓰기 요청의 버퍼에 액세스하는 방법에 대한 자세한 내용은 Framework-Based 드라이버에서 데이터 버퍼 액세스를 참조하세요.
디바이스 또는 드라이버의 WDF_OBJECT_ATTRIBUTES 구조체의 ExecutionLevel 멤버가 WdfExecutionLevelPassive로 설정되지 않는 한 이 콜백 함수는 IRQL <= DISPATCH_LEVEL 호출할 수 있습니다.
IRQL이 PASSIVE_LEVEL 경우 프레임워크는 중요한 지역 내에서 콜백 함수를 호출합니다.
요청 처리기의 IRQL 수준에 대한 자세한 내용은 자동 동기화 사용을 참조하세요.
드라이버의 EvtIoWrite 콜백 함수는 다음 큐 개체 메서드를 호출하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfio.h(Wdf.h 포함) |
| IRQL | <= DISPATCH_LEVEL(설명 섹션 참조) |