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 메서드를 사용하면 드라이버가 Stop이라고 하기 전에 큐가 새 요청을 받지 못하더라도 큐에서 새 요청을 수신할 수 있습니다. 예를 들어 드라이버는 IWDFIoQueue::D rain을 호출하여 프레임워크가 큐에 새 I/O 요청 추가를 중지할 수 있습니다. 드라이버의 후속 Stop 호출은 프레임워크가 큐에 요청 추가를 다시 시작하도록 합니다.

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge