다음을 통해 공유

I/O 큐 관리

I/O 큐 시작하기

드라이버가 WdfIoQueueCreate 호출하여 I/O 큐를 만들면 프레임워크는 자동으로 큐에서 I/O 요청을 수신하고 드라이버에 전달할 수 있도록 합니다.

드라이버는 일반적으로 EvtDriverDeviceAdd 콜백 함수 내에서 WdfIoQueueCreate 호출합니다. 프레임워크는 드라이버의 EvtDriverDeviceAdd 콜백 함수가 반환된 후 드라이버에 I/O 요청을 배달하기 시작할 수 있습니다.

드라이버가 전원 관리 I/O 큐를 사용하는 경우 프레임워크는 디바이스가 작동 상태가 될 때까지 드라이버에 요청을 배달하기 시작할 수 없으며 프레임워크는 드라이버의 EvtDeviceD0Entry 콜백 함수를 호출합니다.

I/O 큐 중지 및 다시 시작

드라이버는 WdfIoQueueStop 호출하거나 WdfIoQueueStopSynchronously프레임워크가 I/O 큐에서 I/O 요청을 배달하지 못하도록 일시적으로 방지할 수 있습니다. I/O 요청 배달을 다시 시작하기 위해 드라이버는 WdfIoQueueStart호출합니다.

드라이버에서 전원 관리형 I/O 큐를 사용하는 경우 디바이스가 작동 중(D0) 상태를 벗어나면 프레임워크가 자동으로 디바이스의 큐를 중지하고, 디바이스 상태가 D0으로 반환되면 프레임워크가 큐를 다시 시작합니다.

I/O 큐에 요청 추가

시스템에서 드라이버에 읽기, 쓰기 또는 디바이스 I/O 제어 요청을 보내면 프레임워크는 I/O 큐에 요청을 배치합니다. 드라이버는 WdfDeviceConfigureRequestDispatching호출하여 프레임워크가 각 큐에 저장하는 요청 유형을 제어할 수 있습니다.

또한 드라이버는 WdfRequestForwardToIoQueue호출하여 프레임워크에서 받은 요청을 다시 큐에 추가할 수 있습니다.

I/O 큐에서 요청 가져오기

드라이버가 I/O 큐에 대해 순차적 또는 병렬 디스패치 메서드를 지정하는 경우 요청 처리기에서 요청을 받습니다.

드라이버가 수동 또는 순차적 디스패치 메서드를 지정하는 경우 WdfIoQueueRetrieveNextRequest 호출하거나 WdfIoQueueRetrieveRequestByFileObject요청을 가져올 수 있습니다.

I/O 요청 검색

드라이버가 I/O 큐에 대한 수동 디스패치 메서드 지정하는 경우 다음 단계를 사용하여 큐에서 특정 요청을 검색할 수 있습니다.

  1. WdfIoQueueFindRequest 호출하여 드라이버 지정 조건과 일치하는 요청을 찾습니다.

  2. WdfIoQueueRetrieveFoundRequest 호출하여 WdfIoQueueFindRequest요청을 검색합니다.

I/O 큐 정리 또는 드레이닝

I/O 큐를 제거한다는 것은 큐에 I/O 요청 삽입을 중지하고 큐에 이미 있는 모든 요청을 취소하는 것을 의미합니다.

I/O 큐에 드레이닝은 큐에 이미 있는 모든 요청이 드라이버에 배달되도록 허용하면서 큐에 I/O 요청 삽입을 중지하는 것을 의미합니다.

드라이버는 일반적으로 큐가 전원 관리되지 않는 경우에만 큐를 제거하거나 비웁니다. 전원 관리형 I/O 큐의 경우 드라이버는 EvtIoStop 및 EvtIoResume 콜백 함수를 제공할 수 있습니다.

드라이버의 일부 큐가 전원 관리되지 않는 경우, 연결된 디바이스 또는 I/O 채널을 사용할 수 없게 되면 큐를 제거하거나 비울 수 있습니다. 일반적으로 각 요청에 매우 중요한 정보가 포함될 가능성이 높지 않으면 큐를 드레이닝하는 대신 제거합니다. 예를 들어 네트워크 디바이스의 드라이버는 큐를 제거할 수 있지만 스토리지 디바이스의 드라이버는 큐를 드레이닝할 수 있습니다.

드라이버가 I/O 큐를 제거하거나 드레이닝하도록 하려면 드라이버는 다음 큐 개체 메서드 중 하나를 호출할 수 있습니다.

WdfIoQueueDrain 및 WdfIoQueueDrainSynchronously호출할 때 주의해야 합니다. 드레이닝 작업은 요청이 처리될 때까지 기다리므로, 보류 중인 요청이 적시에 완료될 것이라고 확신할 수 있을 때만 큐를 드레이닝해야 합니다. I/O 요청이 완료되는 데 걸리는 시간을 모르고 미해결 요청을 취소할 수 있는 경우 큐를 제거하는 것이 좋습니다.

한 I/O 큐에서 다른 큐로 요청 이동

드라이버가 I/O 요청을 받은 후, 그 요청을 다른 I/O 큐로 다시 큐에 넣도록 할 수 있습니다. 이를 위해 드라이버는 WdfRequestForwardToIoQueue 또는 WdfRequestForwardToParentDeviceIoQueue호출합니다. 그러면 지정된 큐의 꼬리에 요청이 추가됩니다. 결국 프레임워크는 지정된 큐의 디스패치 메서드를 사용하여 드라이버에 요청을 다시 전달합니다. I/O 요청을 한 I/O 큐에서 다른 큐로 이동하는 방법에 대한 자세한 내용은 I/O 요청 다시 큐에 넣기를 참조하세요.

큐에 대기되기 전에 I/O 요청을 가로채는

프레임워크가 I/O 큐에 요청을 배치하기 전에 드라이버가 I/O 요청을 가로챌 수 있습니다. I/O 요청을 가로채려면 드라이버가 WdfDeviceInitSetIoInCallerContextCallback 호출하여 EvtIoInCallerContext 콜백 함수를 등록해야 합니다.

프레임워크는 EvtIoInCallerContext 콜백 함수를 디바이스와 연결합니다. 따라서 프레임워크는 시스템에서 디바이스로 보내는 요청을 받을 때마다 EvtIoInCallerContext 콜백 함수를 호출합니다.

일반적으로 EvtIoInCallerContext 콜백 함수가 요청을 받으면 요청에 대한 일부 예비 처리를 수행합니다. 다음으로, 콜백 함수는 WdfDeviceEnqueueRequest호출하여 프레임워크에 요청을 다시 제공합니다. 그런 다음 프레임워크는 EvtIoInCallerContext 콜백 함수를 호출하지 않은 경우와 마찬가지로 적절한 I/O 큐에 요청을 배치할 수 있습니다.

드라이버가 EvtIoInCallerContext 콜백 함수를 제공할 수 있는 주된 이유는 드라이버가 버퍼링되거나 직접 I/O 호출되는 I/O 메서드를 지원하는 I/O 작업을 처리해야 하기 때문입니다. 이 I/O 메서드의 경우 드라이버는 I/O 요청의 생성자의 프로세스 컨텍스트에서 수신된 버퍼에 액세스해야 합니다. 자세한 내용은 Framework-Based 드라이버 데이터 버퍼 액세스참조하세요.

I/O 큐 속성 가져오기

프레임워크 큐 개체의 속성을 가져오기 위해 드라이버는 다음 메서드를 호출할 수 있습니다.