Delen via

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

vereisten voor objecten

  • Last updated on