다음을 통해 공유

Device 개체

  • 아티클

디바이스 개체는 다음 속성을 지원합니다. 애플리케이션은 루트 개체를 쿼리하여 이러한 속성을 요청할 수 있습니다(정의된 WPD_DEVICE_OBJECT_ID 상수 개체 ID 지정). 디바이스 개체의 모든 값은 읽기 전용입니다.

지정된 디바이스가 WPD_FUNCTIONAL_CATEGORY_DEVICE 범주를 구현하는 경우 해당 범주와 연결된 속성도 지원해야 합니다.

속성 이름 필수 또는 선택 사항
WPD_OBJECT_ID 필수 사항입니다. 값이 WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID 필수 사항입니다. 값이 빈 문자열인 경우
WPD_OBJECT_NAME 개체가 파일을 나타내는 경우 필수입니다.
WPD_OBJECT_PERSISTENT_UNIQUE_ID 필수 사항입니다.
WPD_OBJECT_ISHIDDEN 디바이스 개체를 사용자에게 표시하지 않아야 하는 경우 필수입니다.
WPD_OBJECT_REFERENCES 디바이스 개체에 다른 개체에 대한 참조가 있는 경우 필요합니다.
WPD_OBJECT_KEYWORDS 선택 사항입니다.
WPD_OBJECT_SYNC_ID 선택 사항입니다.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE 선택 사항입니다.
WPD_DEVICE_SYNC_PARTNER 선택 사항입니다.
WPD_DEVICE_FIRMWARE_VERSION 필수 사항입니다.
WPD_DEVICE_POWER_LEVEL 디바이스에 배터리가 있는 경우 권장합니다.
WPD_DEVICE_POWER_SOURCE 권장됩니다.
WPD_DEVICE_PROTOCOL 권장됩니다.
WPD_DEVICE_MANUFACTURER 필수 사항입니다.
WPD_DEVICE_MODEL 필수 사항입니다.
WPD_DEVICE_SERIAL_NUMBER 필수 사항입니다.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE 디바이스에서 소모성이 없는 개체를 지원하는 경우 필수입니다. 즉, 간단한 데이터 스토리지에 사용할 수 있는 경우 입니다.
WPD_DEVICE_DATETIME 선택 사항입니다.
WPD_DEVICE_FRIENDLY_NAME 권장됩니다.
WPD_DEVICE_SUPPORTED_DRM_SCHEME 디바이스에서 DRM(디지털 권한 관리)을 지원하는 경우 권장됩니다.
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED 디바이스에서 기본 형식 순서 지정을 지원하는 경우 권장됩니다.
WPD_DEVICE_TYPE 권장됩니다.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID 선택 사항입니다.
WPD_DEVICE_MODEL_UNIQUE_ID 선택 사항입니다.
WPD_DEVICE_TRANSPORT 권장됩니다.
WPD_DEVICE_USE_DEVICE_STAGE 선택 사항입니다.
WPD_FUNCTIONAL_OBJECT_CATEGORY 필수 사항입니다.

일반적인 리소스

이러한 개체는 일반적으로 리소스를 호스트하지 않습니다.

명령

디바이스는 속성 외에도 Windows 휴대용 디바이스에서 정의한 특정 명령 집합을 지원해야 합니다. 개체 또는 디바이스에서 지원하는 명령은 해당 유형, 기능 및 기능에 따라 달라집니다.

다음 표에서는 기능별로 디바이스에 적용되는 명령 클래스에 대해 설명합니다. 일반적으로 디바이스는 여러 범주에 속하며 적용 가능한 모든 범주에 대한 명령을 지원해야 합니다. 예를 들어 카메라가 있는 휴대폰은 모든 디바이스, SMS 디바이스 및 스틸 이미지 캡처 디바이스의 세 가지 범주에 속합니다. 사용자 지정 드라이버 및 클라이언트 애플리케이션은 사용자가 정의하는 추가 명령 또는 속성을 지원할 수 있지만 다음 명령을 지원해야 합니다. 각 명령 범주에 속하는 특정 명령에 대한 설명은 명령을 참조하세요.

설명 명령 범주
모든 디바이스. WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON
WPD_CATEGORY_OBJECT_ENUMERATION
WPD_CATEGORY_OBJECT_MANAGEMENT
WPD_CATEGORY_OBJECT_PROPERTIES
WPD_CATEGORY_OBJECT_PROPERTIES_BULK
WPD_CATEGORY_OBJECT_RESOURCES
디지털 카메라와 같은 스틸 이미지를 캡처할 수 있는 디바이스입니다. WPD_CATEGORY_STILL_IMAGE_CAPTURE
휴대폰과 같은 SMS(짧은 메시지 서비스) 메시지를 보낼 수 있는 디바이스입니다. SMS 메시지 보내기를 "문자 메시지"라고도 합니다. WPD_CATEGORY_SMS
스토리지 디바이스로 작동하는 디바이스입니다. 여기에는 외부 드라이브가 포함됩니다. 디바이스가 저장소의 서식을 지정하거나 개체를 한 위치에서 다른 위치로 이동하는 기능을 지원하는 경우 드라이버는 이 범주를 지원해야 합니다.
 WPD_CATEGORY_STORAGE

개체에 대한 요구 사항