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