IWDFIoRequest2::Reuse 메서드(wudfddi.h)

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

Reuse 메서드는 프레임워크 요청 개체를 다시 초기화하여 다시 사용할 수 있도록 합니다.

구문

void Reuse(
  [in] HRESULT hrNewStatus
);

매개 변수

[in] hrNewStatus

프레임워크가 요청에 할당하는 HRESULT 형식의 상태 값입니다.

반환 값

없음

설명

프레임워크 기반 드라이버가 IWDFDevice::CreateRequest 를 호출하여 요청 개체를 만드는 경우 드라이버는 해당 요청 개체를 다시 사용할 수 있습니다. 드라이버는 I/O 큐의 프레임워크에서 수신하는 요청 개체를 다시 사용할 수도 있습니다.

드라이버는 원래 요청이 완료된 후 요청 개체를 다시 사용할 수 있습니다. 드라이버가 Reuse를 호출한 후 요청의 콘텐츠를 다시 초기화해야 합니다.

재사용된 요청에 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수가 있도록 하려면 드라이버가 Reuse를 호출한 후 IWDFIoRequest::SetCompletionCallback을 호출해야 합니다.

재사용에 대한 자세한 내용은 프레임워크 요청 개체 재사용을 참조하세요.

예제

다음 코드 예제에서는 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수가 IWDFIoRequest2 인터페이스를 가져온 다음 , Reuse를 호출하는 방법을 보여줍니다.

void 
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
    __in IWDFIoRequest*  FxRequest,
    __in IWDFIoTarget*  FxTarget,
    __in IWDFRequestCompletionParams*  Params,
    __in void*  Context
    )
{
...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->Reuse(S_OK);
...
}

요구 사항

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

추가 정보

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2

IWDFIoRequest::SetCompletionCallback