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 |