Apparaatobject

Het apparaatobject ondersteunt de volgende eigenschappen. Een toepassing kan deze eigenschappen aanvragen door een query uit te voeren op het hoofdobject (waarbij de gedefinieerde WPD_DEVICE_OBJECT_ID constante object-id wordt opgegeven). Alle waarden van het apparaatobject zijn alleen-lezen.

Als een bepaald apparaat de WPD_FUNCTIONAL_CATEGORY_DEVICE categorie implementeert, moet het ook ondersteuning bieden voor de eigenschappen die aan die categorie zijn gekoppeld.

Naam van eigenschap	Vereist of optioneel
WPD_OBJECT_ID	Vereist. De waarde is WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID	Vereist. De waarde is een lege tekenreeks.
WPD_OBJECT_NAME	Vereist als het object een bestand vertegenwoordigt.
WPD_OBJECT_PERSISTENT_UNIQUE_ID	Vereist.
WPD_OBJECT_ISHIDDEN	Vereist als het apparaatobject niet aan de gebruiker mag worden weergegeven.
WPD_OBJECT_REFERENCES	Vereist als het apparaatobject verwijzingen naar andere objecten bevat.
WPD_OBJECT_KEYWORDS	Facultatief.
WPD_OBJECT_SYNC_ID	Facultatief.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE	Facultatief.
WPD_DEVICE_SYNC_PARTNER	Facultatief.
WPD_DEVICE_FIRMWARE_VERSION	Vereist.
WPD_DEVICE_POWER_LEVEL	Aanbevolen als het apparaat een batterij heeft.
WPD_DEVICE_POWER_SOURCE	Aanbevolen.
WPD_DEVICE_PROTOCOL	Aanbevolen.
WPD_DEVICE_MANUFACTURER	Vereist.
WPD_DEVICE_MODEL	Vereist.
WPD_DEVICE_SERIAL_NUMBER	Vereist.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE	Vereist als het apparaat niet-verbruikbare objecten ondersteunt; dat wil gezegd, als deze kan worden gebruikt voor eenvoudige gegevensopslag.
WPD_DEVICE_DATETIME	Facultatief.
WPD_DEVICE_FRIENDLY_NAME	Aanbevolen.
WPD_DEVICE_SUPPORTED_DRM_SCHEME	Aanbevolen als het apparaat DRM (Digital Rights Management) ondersteunt.
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED	Aanbevolen als het apparaat de volgorde van voorkeursindelingen ondersteunt.
WPD_DEVICE_TYPE	Aanbevolen.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID	Facultatief.
WPD_DEVICE_MODEL_UNIQUE_ID	Facultatief.
WPD_DEVICE_TRANSPORT	Aanbevolen.
WPD_DEVICE_USE_DEVICE_STAGE	Facultatief.
WPD_FUNCTIONAL_OBJECT_CATEGORY	Vereist.

Typische resources

Deze objecten hosten doorgaans geen resources.

Opdrachten

Naast eigenschappen moeten apparaten een specifieke set opdrachten ondersteunen die zijn gedefinieerd door Windows Portable Devices. Welke opdrachten een object of apparaat ondersteunt, is afhankelijk van het type, de functionaliteit en de mogelijkheden.

In de volgende tabel worden de opdrachtklassen beschreven die van toepassing zijn op apparaten, op basis van functionaliteit. Normaal gesproken valt een apparaat onder verschillende categorieën en moet het de opdrachten voor alle toepasselijke categorieën ondersteunen. Een mobiele telefoon met een camera valt bijvoorbeeld onder drie categorieën: alle apparaten, sms-apparaten en nog steeds afbeeldingen vastleggen. Een aangepast stuurprogramma en clienttoepassing kunnen aanvullende opdrachten of eigenschappen ondersteunen die u definieert, maar moeten de volgende opdrachten ondersteunen. Zie Opdrachtenvoor een beschrijving van de specifieke opdrachten die onder elke opdrachtcategorie vallen.

Beschrijving	Opdrachtcategorieën
Alle apparaten.	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
Apparaten die nog steeds afbeeldingen kunnen vastleggen, zoals digitale camera's.	WPD_CATEGORY_STILL_IMAGE_CAPTURE
Apparaten die sms-berichten (short message service) kunnen verzenden, zoals mobiele telefoons. Het verzenden van sms-berichten wordt vaak 'sms-berichten' genoemd.	WPD_CATEGORY_SMS
Apparaten die fungeren als opslagapparaten. Dit zijn onder andere externe stations. Als een apparaat de mogelijkheid ondersteunt om een archief op te maken of objecten van de ene locatie naar de andere te verplaatsen, moet uw stuurprogramma deze categorie ondersteunen.	WPD_CATEGORY_STORAGE

Verwante onderwerpen

vereisten voor objecten