Udostępnij przez


Obiekt urządzenia

Obiekt urządzenia obsługuje następujące właściwości. Aplikacja może zażądać tych właściwości, wysyłając zapytanie do obiektu głównego (określając zdefiniowany WPD_DEVICE_OBJECT_ID identyfikator obiektu stałego). Wszystkie wartości obiektu urządzenia są tylko do odczytu.

Jeśli dane urządzenie implementuje kategorię WPD_FUNCTIONAL_CATEGORY_DEVICE, musi również obsługiwać właściwości skojarzone z tą kategorią.

Nazwa właściwości Wymagane lub opcjonalne
WPD_OBJECT_ID Wymagane. Wartość to WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Wymagane. Wartość jest pustym ciągiem.
WPD_OBJECT_NAME Wymagane, jeśli obiekt reprezentuje plik.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Wymagane.
WPD_OBJECT_ISHIDDEN Wymagane, jeśli obiekt urządzenia nie powinien być wyświetlany użytkownikowi.
WPD_OBJECT_REFERENCES Wymagane, jeśli obiekt urządzenia zawiera odwołania do innych obiektów.
WPD_OBJECT_KEYWORDS Fakultatywny.
WPD_OBJECT_SYNC_ID Fakultatywny.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Fakultatywny.
WPD_DEVICE_SYNC_PARTNER Fakultatywny.
WPD_DEVICE_FIRMWARE_VERSION Wymagane.
WPD_DEVICE_POWER_LEVEL Zalecane, jeśli urządzenie ma baterię.
WPD_DEVICE_POWER_SOURCE Zalecane.
WPD_DEVICE_PROTOCOL Zalecane.
WPD_DEVICE_MANUFACTURER Wymagane.
WPD_DEVICE_MODEL Wymagane.
WPD_DEVICE_SERIAL_NUMBER Wymagane.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Wymagane, jeśli urządzenie obsługuje obiekty nieużywane; oznacza to, że można go użyć do prostego magazynu danych.
WPD_DEVICE_DATETIME Fakultatywny.
WPD_DEVICE_FRIENDLY_NAME Zalecane.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Zalecane, jeśli urządzenie obsługuje usługę Digital Rights Management (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Zalecane, jeśli urządzenie obsługuje preferowaną kolejność formatów.
WPD_DEVICE_TYPE Zalecane.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Fakultatywny.
WPD_DEVICE_MODEL_UNIQUE_ID Fakultatywny.
WPD_DEVICE_TRANSPORT Zalecane.
WPD_DEVICE_USE_DEVICE_STAGE Fakultatywny.
WPD_FUNCTIONAL_OBJECT_CATEGORY Wymagane.

Typowe zasoby

Te obiekty zwykle nie hostują zasobów.

Polecenia

Oprócz właściwości urządzenia powinny obsługiwać określony zestaw poleceń zdefiniowanych przez urządzenia przenośne z systemem Windows. Polecenia obsługiwane przez obiekt lub urządzenie zależą od jego typu, funkcjonalności i możliwości.

W poniższej tabeli opisano klasy poleceń, które mają zastosowanie do urządzeń według funkcji. Zazwyczaj urządzenie należy do kilku kategorii i powinno obsługiwać polecenia dla wszystkich odpowiednich kategorii. Na przykład telefon komórkowy z kamerą mieści się w trzech kategoriach: wszystkie urządzenia, urządzenia SMS i urządzenia do przechwytywania obrazów. Niestandardowy sterownik i aplikacja kliencka mogą obsługiwać dodatkowe zdefiniowane polecenia lub właściwości, ale muszą obsługiwać następujące polecenia. Aby uzyskać opis określonych poleceń, które należą do każdej kategorii poleceń, zobacz Polecenia.

Opis Kategorie poleceń
Wszystkie urządzenia. 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
Urządzenia, które mogą przechwytywać obrazy, takie jak cyfrowe aparaty fotograficzne. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Urządzenia, które mogą wysyłać wiadomości SMS, takie jak telefony komórkowe. Wysyłanie wiadomości SMS jest często nazywane "wiadomościami sms". WPD_CATEGORY_SMS
Urządzenia, które działają jako urządzenia magazynujące. Należą do nich dyski zewnętrzne. Jeśli urządzenie obsługuje możliwość formatowania magazynu lub przenoszenia obiektów z jednej lokalizacji do innej, sterownik powinien obsługiwać tę kategorię.
WPD_CATEGORY_STORAGE

wymagania dotyczące obiektów