IUsbTargetPipeContinuousReaderCallbackReadersFailed::OnReaderFailure 메서드(wudfusb.h)

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

드라이버의 OnReaderFailure 이벤트 콜백 함수는 연속 판독기가 읽기 요청을 처리하는 동안 오류를 보고했음을 드라이버에 알릴 수 있습니다.

통사론

BOOL OnReaderFailure(
  [in] IWDFUsbTargetPipe *pPipe,
  [in] HRESULT           hrStatus
);

매개 변수

[in] pPipe

드라이버에서 연속 판독기를 사용하도록 설정한 USB 파이프에 대한 IWDFUsbTargetPipe 인터페이스에 대한 포인터입니다.

[in] hrStatus

USB 파이프의 I/O 대상이 반환한 HRESULT 형식 상태 값입니다.

반환 값

OnReaderFailure 이벤트 콜백 함수는 부울 값을 반환해야 합니다. 반환 값이 TRUE 경우 프레임워크는 USB 파이프를 다시 시작한 다음 연속 판독기를 다시 시작합니다. 콜백 함수가 FALSE 반환하는 경우 프레임워크는 디바이스를 다시 설정하거나 연속 판독기를 다시 시작하지 않습니다.

발언

OnReaderFailure 콜백 함수를 등록하려면 드라이버가 IWDFUsbTargetPipe2::ConfigureContinuousReader호출할 때 드라이버의 IUsbTargetPipeContinuousReaderCallbackReadersFailed 인터페이스에 대한 포인터를 제공해야 합니다.

드라이버가 USB 파이프에 대한 연속 판독기를 만든 경우 드라이버의 I/O 대상이 읽기 요청을 완료할 때 오류를 보고하는 경우 프레임워크는 드라이버의 OnReaderFailure 콜백 함수를 호출합니다. (I/O 대상이 요청을 성공적으로 완료하면 프레임워크는 드라이버의 IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion 콜백 함수를 호출합니다.)

프레임워크는 드라이버의 OnReaderFailure 콜백 함수를 호출하기 전에 진행 중인 모든 읽기 요청을 취소하려고 시도합니다. 프레임워크가 OnReaderFailure 콜백 함수를 호출할 때 읽기 요청이 진행되지 않습니다. 프레임워크는 OnReaderFailure 콜백 함수가 반환될 때까지 추가 읽기 요청을 큐에 대기하지 않습니다.

프레임워크가 OnReaderFailure 콜백 함수에 대한 호출을 다른 콜백 함수에 대한 호출과 동기화하는 방법에 대한 자세한 내용은 IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion설명 섹션을 참조하세요.

OnReaderFailure 콜백 함수는 IWDFIoTargetStateManagement::stop 호출하여 연속 판독기 USB 대상을 중지하면 안 됩니다. 실제로 OnReaderFailure 콜백 함수에서 IWDFIoTargetStateManagement::Stop 호출하면 교착 상태가 발생합니다. 또한 콜백 함수는 IWDFIoTargetStateManagement::Start 호출하여 연속 판독기를 다시 시작해서는 안 됩니다. 대신 콜백 함수가 TRUE 반환하는 경우 프레임워크가 판독기를 다시 시작합니다. IWDFIoTargetStateManagement::start 및 IWDFIoTargetStateManagement::Stop 연속 판독기를 호출하는 경우에 대한 자세한 내용은 UMDF USB 파이프 작업참조하세요.

드라이버가 OnReaderFailure 콜백 함수를 제공하지 않고 드라이버의 I/O 대상이 오류를 보고하는 경우 프레임워크는 USB 파이프를 재설정하고 연속 판독기를 다시 시작합니다.

OnReaderFailure 콜백 함수 및 USB I/O 대상에 대한 자세한 내용은 USB I/O 대상 처리를 참조하세요.

요구 사항

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

참고 항목

IUsbTargetPipeContinuousReaderCallbackReadComplete::OnReaderCompletion

IUsbTargetPipeContinuousReaderCallbackReadersFailed