다음을 통해 공유

IWDFRemoteTarget::Reopen 메서드(wudfddi.h)

  • 아티클

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

Reopen 메서드는 일시적으로 닫힌 후 원격 I/O 대상 다시 엽니다.

통사론

HRESULT Reopen();

반환 값

다시 열기 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드가 다음 값을 반환할 수 있습니다.

반환 코드 묘사
E_OUTOFMEMORY
 프레임워크의 메모리 할당 시도가 실패했습니다.
 

이 메서드는 Winerror.h에 포함된 다른 값 중 하나를 반환할 수 있습니다.

프레임워크의 검증 도구는 프레임워크가 파일을 열 수 없는 경우 오류를 보고할 있습니다.

발언

일반적으로 드라이버는 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled 콜백 함수 내에서 다시 열기 호출하지만 다시 열기OnRemoteTargetRemoveCanceled 반환된 후에 호출할 수 있습니다.

다시 열기는 이전에 드라이버가 IWDFRemoteTarget::OpenFileByName 또는 IWDFRemoteTarget::OpenRemoteInterface 위해 지정한 파일 또는 인터페이스 이름을 사용합니다. 드라이버에서 사용 중인 파일 또는 인터페이스를 변경하려는 경우 드라이버는 IWDFRemoteTarget::Close호출한 다음 OpenFileByName 호출하거나 OpenRemoteInterface다시 열기대신 호출할 수 있습니다.

다시 열기 및 UMDF 기반 드라이버에서 원격 I/O 대상을 사용하는 방법에 대한 자세한 내용은 UMDF일반 I/O 대상의 상태를 제어하는 방법을 참조하세요.

예제

다음 코드 예제에서는 다시 열기호출하는 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled 콜백 함수를 보여줍니다.

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       FxTarget->Close();
    }
}

요구 사항

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

참고 항목

IWDFRemoteTarget

IWDFRemoteTarget::close