Compartir a través de

Device (objeto)

  • Artículo

El objeto device admite las siguientes propiedades. Una aplicación puede solicitar estas propiedades consultando el objeto raíz (especificando el identificador de objeto constante definido WPD_DEVICE_OBJECT_ID ). Todos los valores del objeto de dispositivo son de solo lectura.

Si un dispositivo determinado implementa la categoría WPD_FUNCTIONAL_CATEGORY_DEVICE , también debe admitir las propiedades asociadas a esa categoría.

Nombre de propiedad Obligatorio u opcional
WPD_OBJECT_ID Necesario. El valor es WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Necesario. El valor es una cadena vacía.
WPD_OBJECT_NAME Obligatorio si el objeto representa un archivo.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Necesario.
WPD_OBJECT_ISHIDDEN Obligatorio si el objeto de dispositivo no debe mostrarse al usuario.
WPD_OBJECT_REFERENCES Obligatorio si el objeto de dispositivo tiene referencias a otros objetos.
WPD_OBJECT_KEYWORDS Opcional.
WPD_OBJECT_SYNC_ID Opcional.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Opcional.
WPD_DEVICE_SYNC_PARTNER Opcional.
WPD_DEVICE_FIRMWARE_VERSION Necesario.
WPD_DEVICE_POWER_LEVEL Se recomienda si el dispositivo tiene una batería.
WPD_DEVICE_POWER_SOURCE Se recomienda su uso.
WPD_DEVICE_PROTOCOL Se recomienda su uso.
WPD_DEVICE_MANUFACTURER Necesario.
WPD_DEVICE_MODEL Necesario.
WPD_DEVICE_SERIAL_NUMBER Necesario.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Obligatorio si el dispositivo admite objetos no consumibles; es decir, si se puede usar para el almacenamiento de datos simple.
WPD_DEVICE_DATETIME Opcional.
WPD_DEVICE_FRIENDLY_NAME Se recomienda su uso.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Se recomienda si el dispositivo admite Digital Rights Management (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Se recomienda si el dispositivo admite el orden de formato preferido.
WPD_DEVICE_TYPE Se recomienda su uso.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Opcional.
WPD_DEVICE_MODEL_UNIQUE_ID Opcional.
WPD_DEVICE_TRANSPORT Se recomienda su uso.
WPD_DEVICE_USE_DEVICE_STAGE Opcional.
WPD_FUNCTIONAL_OBJECT_CATEGORY Necesario.

Recursos típicos

Normalmente, estos objetos no hospedan recursos.

Comandos

Además de las propiedades, los dispositivos deben admitir un conjunto específico de comandos definidos por dispositivos portátiles de Windows. Los comandos que admite un objeto o dispositivo dependen de su tipo, funcionalidad y funcionalidades.

En la tabla siguiente se describen las clases de comandos que se aplican a los dispositivos, por funcionalidad. Normalmente, un dispositivo se encuentra en varias categorías y debe admitir los comandos para todas las categorías aplicables. Por ejemplo, un teléfono móvil con una cámara estaría en tres categorías: todos los dispositivos, dispositivos SMS y dispositivos de captura de imágenes. Una aplicación cliente y un controlador personalizado pueden admitir comandos o propiedades adicionales que defina, pero deben admitir los siguientes comandos. Para obtener una descripción de los comandos específicos que se encuentran en cada categoría de comandos, consulte Comandos.

Descripción Categorías de comandos
Todos los dispositivos. 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
Dispositivos que pueden capturar imágenes fijas, como cámaras digitales. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Dispositivos que pueden enviar mensajes de servicio de mensajes cortos (SMS), como teléfonos móviles. El envío de mensajes SMS suele denominar "mensajería de texto". WPD_CATEGORY_SMS
Dispositivos que funcionan como dispositivos de almacenamiento. Entre ellas se incluyen unidades externas. Si un dispositivo admite la capacidad de dar formato a un almacén o mover objetos de una ubicación a otra, el controlador debe admitir esta categoría.
 WPD_CATEGORY_STORAGE

Requisitos para objetos