다음을 통해 공유

IWDFIoQueue::Stop 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.

Stop 메서드는 I/O 큐가 I/O 요청을 배달하지 못하도록 차단하지만 큐는 새 요청을 수신하고 저장합니다.

통사론

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

매개 변수

[in, optional] pStopComplete

드라이버에서 모든 미해결 I/O 요청(있는 경우)이 완료된 후 프레임워크가 호출하는 IQueueCallbackStateChange 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.

반환 값

없음

발언

중지 호출은 비동기적이며 즉시 드라이버로 돌아갑니다. 드라이버의 모든 미해결 요청이 완료된 후 제공된 IQueueCallbackStateChange 인터페이스의 메서드를 통해 드라이버에 알림을 받습니다.

드라이버는 지정된 시간에 다음 방법 중 하나만 진행 중인지 확인해야 합니다.

예를 들어 이전에 Stop호출한 드라이버의 경우 드라이버가 드레이닝 또는 제거호출하기 전에 pStopComplete 매개 변수가 가리키는 인터페이스 메서드의 알림을 기다려야 합니다. 이 규칙을 위반하면 호스트 프로세스가 종료됩니다.

Stop 메서드를 사용하면 드라이버가 중지호출되기 전에 큐가 새 요청을 수신하지 않은 경우에도 큐가 새 요청을 수신할 수 있습니다. 예를 들어 드라이버는 IWDFIoQueue::D rain호출하여 프레임워크가 큐에 새 I/O 요청 추가를 중지할 수 있습니다. 드라이버의 후속 중지 호출하면 프레임워크가 큐에 요청 추가를 다시 시작합니다.

요구 사항

요구 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 바탕 화면
최소 UMDF 버전 1.5
헤더 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

참고 항목

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P