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 큐의 프레임워크에서 수신하는 요청 개체를 다시 사용할 수도 있습니다.
드라이버는 원래 요청이 완료된 후 요청 개체를 다시 사용할 수 있습니다. 드라이버가 다시 사용호출한 후 요청의 내용을 다시 초기화해야 합니다.
재사용된 요청이 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수를 갖도록 하려면 드라이버가 다시 사용호출한 후 IWDFIoRequest::SetCompletionCallback을 호출해야 합니다.
다시 사용대한 자세한 내용은 프레임워크 요청 개체 다시참조하세요.
예제
다음 코드 예제에서는 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수가 IWDFIoRequest2 인터페이스를 가져온 다음 다시 사용호출하는 방법을 보여줍니다.
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 |