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 반환합니다. 그렇지 않으면 메서드는 다음 값을 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
프레임워크의 메모리 할당 시도가 실패했습니다. |
이 메서드는 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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기