IWDFDevice2::CreateRemoteTarget 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
CreateRemoteTarget 메서드는 원격 I/O 대상을 나타내는 원격 대상 개체를 만듭니다.
구문
HRESULT CreateRemoteTarget(
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFRemoteTarget **ppRemoteTarget
);
매개 변수
[in, optional] pCallbackInterface
선택적 드라이버 제공 콜백 인터페이스에 대한 포인터입니다. 이 인터페이스의 IUnknown::QueryInterface 메서드는 드라이버가 해당 인터페이스를 지원하는 경우 드라이버의 IRemoteTargetCallbackRemoval 인터페이스에 대한 포인터를 반환해야 합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in, optional] pParentObject
프레임워크 개체에 대한 포인터입니다. 드라이버가 이 선택적 포인터를 제공하는 경우 지정된 개체는 새 원격 대상 개체의 부모가 됩니다. 이 매개 변수가 NULL이면 IWDFDevice2 인터페이스를 제공하는 디바이스 개체가 부모가 됩니다. 프레임워크는 부모 개체를 삭제할 때 원격 대상 개체를 삭제합니다.
[out] ppRemoteTarget
새 원격 대상 개체의 IWDFRemoteTarget 인터페이스에 대한 포인터를 수신하는 위치에 대한 포인터입니다.
반환 값
CreateRemoteTarget 은 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드는 다음 값을 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
프레임워크의 메모리 할당 시도가 실패했습니다. |
|
pParentObject 매개 변수는 IWDFDevice2 인터페이스를 제공하는 디바이스 개체 또는 부모 체인이 해당 개체로 이어지는 개체를 지정하지 않았습니다. |
이 메서드는 Winerror.h에 포함된 다른 값 중 하나를 반환할 수 있습니다.
설명
드라이버가 CreateRemoteTarget을 호출한 후 드라이버는 IWDFRemoteTarget::OpenRemoteInterface ( 디바이스 인터페이스를 열기 위해) 또는 IWDFRemoteTarget::OpenFileByName (파일을 열기 위해)을 호출하여 원격 대상을 열 수 있습니다.
드라이버가 pParentObject 매개 변수를 사용하여 부모 개체를 지정하는 경우 부모 개체는 IWDFDevice2 인터페이스를 제공하는 디바이스 개체이거나 부모 체인이 해당 디바이스 개체로 이어지는 모든 개체일 수 있습니다. 프레임워크는 원격 대상 개체(또는 드라이버)가 디바이스 개체를 삭제할 때 삭제합니다.
원격 I/O 대상에 대한 자세한 내용은 UMDF에서 I/O 대상 사용을 참조하세요.
예제
CreateRemoteTarget을 사용하는 코드 예제는 IWDFDevice2::CreateRemoteInterface 및 IWDFRemoteTarget::OpenFileByName의 코드 예제를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.9 |
| 머리글 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |