IPortableDevice 인터페이스(portabledeviceapi.h)
IPortableDevice 인터페이스는 휴대용 디바이스에 대한 액세스를 제공합니다.
이 인터페이스를 만들고 열려면 먼저 CLSID_PortableDeviceFTM 또는 CLSID_PortableDevice사용하여 CoCreateInstance를 호출하여 IPortableDevice 인터페이스를 검색한 다음 Open을 호출하여 디바이스에 대한 연결을 엽니다.
상속
IPortableDevice 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IPortableDevice 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IPortableDevice 인터페이스에는 이러한 메서드가 있습니다.
| IPortableDevice::Advise Advise 메서드는 디바이스 이벤트를 수신하는 애플리케이션 정의 콜백을 등록합니다. |
| IPortableDevice::Cancel Cancel 메서드는 이 인터페이스에서 보류 중인 작업을 취소합니다. |
| IPortableDevice::Capabilities Capabilities 메서드는 휴대용 디바이스의 기능을 쿼리하는 데 사용되는 인터페이스를 검색합니다. |
| IPortableDevice::Close Close 메서드는 디바이스와의 연결을 닫습니다. |
| IPortableDevice::Content Content 메서드는 디바이스의 개체에 액세스하는 데 사용할 수 있는 인터페이스를 검색합니다. |
| IPortableDevice::GetPnPDeviceID GetPnPDeviceID 메서드는 애플리케이션이 디바이스를 여는 데 사용한 PnP(플러그 앤 플레이) 디바이스 식별자를 검색합니다. |
| IPortableDevice::Open Open 메서드는 애플리케이션과 디바이스 간의 연결을 엽니다. |
| IPortableDevice::SendCommand SendCommand 메서드는 디바이스에 명령을 보내고 결과를 동기적으로 검색합니다. |
| IPortableDevice::Unadvise Unadvise 메서드는 클라이언트가 콜백 알림을 받지 못하도록 등록을 취소합니다. 이전에 Advise를 호출한 경우 이 메서드를 호출해야 합니다. |
설명
클라이언트 인터페이스는 모든 WPD 개체에 사용하도록 설계되었습니다. 애플리케이션에서 참조하는 각 개체에 대한 새 instance 만들 필요는 없습니다. 애플리케이션이 IPortableDevice 인터페이스의 instance 열고 필요한 다른 WPD 클라이언트 인터페이스를 캐시해야 합니다.
Windows 7의 경우 IPortableDevice 는 CoCreateInstance에 대해 두 개의 CLSID를 지원합니다. CLSID_PortableDevice 자유 스레드 마샬러를 집계하지 않는 IPortableDevice 포인터를 반환합니다. CLSID_PortableDeviceFTM 자유 스레드 마샬러를 집계하는 IPortableDevice 포인터를 반환하는 새 CLSID입니다. 그렇지 않으면 두 포인터 모두 동일한 기능을 지원합니다.
단일 스레드 아파트에 거주하는 애플리케이션은 인터페이스 포인터 마샬링의 오버헤드를 제거하기 때문에 CLSID_PortableDeviceFTM 사용해야 합니다. CLSID_PortableDevice 여전히 레거시 애플리케이션에 지원됩니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |