Geräteeigenschaften (PortableDevice.h)
Tragbare Windows-Geräte unterstützen die folgenden Geräteeigenschaften.
| Eigenschaft | VarType | BESCHREIBUNG |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | Das aktuelle Datum und die aktuelle Uhrzeit auf dem Gerät. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | Die Firmwareversion des Geräts. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Ein eindeutiger 16-Byte-Bezeichner, der für mehrere Transporte gilt, die vom Gerät unterstützt werden. Wenn ein einzelnes Gerät mehrere Transporte unterstützt, kann diese Eigenschaft verwendet werden, um die verschiedenen Transport-WPD-Treiber diesem Gerät zuzuordnen. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Ein für Menschen lesbarer Geräteherstellername. |
| WPD_DEVICE_MODEL | VT_LPWSTR | Das Gerätemodell. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Ein eindeutiger 16-Byte-Bezeichner, der verwendet wird, um zwischen verschiedenen Modellen eines Geräts zu unterscheiden. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Ein -Wert, der den EUI-64-Netzwerkbezeichner des Geräts angibt; Diese Eigenschaft wird für Out-of-Band-Netzwerkvorgänge verwendet. Wenn das Gerät über physische Mac-48-Netzwerkadressen verfügt (typisch für IPv4-Netzwerke), wird die MAC-48-Adresse in der EUI-64-Adresse als die beiden Hälften der MAC-48-Adresse durch FF-FF getrennt codiert. Der EUI-64-Wert wird in der Reihenfolge "network" oder "big-endian" gespeichert, wobei eine EUI-64-Adresse 01-02-03-FF-FF-04-05-06 in der VT_UI8 platziert wird, sodass der Dezimalwert 72624942021346566 wird. Diese Eigenschaft ist auf jedem Gerät erforderlich, das nominale oder sichere Authentifizierung unterstützt. Diese Eigenschaft wird auf Geräten empfohlen, die nur Zero Authentication unterstützen. Der Wert kann vom Host verwendet werden, um den Zugriff auf das Gerät ohne Benutzereingriff automatisch herzustellen. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Ein Wert von 0 bis 100, der den Leistungszustand des Akkus des Geräts angibt, wobei 0 keine ist und 100 vollständig aufgeladen ist. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Eine WPD_POWER_SOURCES-Enumeration , die die Stromquelle des Geräts angibt. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | Das verwendete Geräteprotokoll. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | Die Seriennummer des Geräts. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Ein -Wert, der angibt, ob die vom Gerät zurückgegebenen unterstützten Formate in einer bevorzugten Reihenfolge vorliegen. Das erste Format in der Liste wird vom Gerät am meisten bevorzugt, während das letzte das am wenigsten bevorzugte Format ist. Anwendungen können diese Eigenschaft verwenden, um zu bestimmen, ob die unterstützten Formate eines Geräts in einer bevorzugten Reihenfolge aufgeführt sind. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Ein boolescher Wert, der angibt, ob die vom Gerät zurückgegebenen unterstützten Formate in einer bevorzugten Reihenfolge vorliegen. Das heißt, das erste zurückgegebene Format wird am meisten bevorzugt, während das zuletzt zurückgegebene Format am wenigsten bevorzugt ist. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Ein boolescher Wert, der angibt, ob das Gerät nicht verbrauchsbare Objekte unterstützt. Dies sind Objekte, die das Gerät nur speichern, nicht wiedergeben oder in irgendeiner Weise verwenden soll. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Eine lesbare Beschreibung des Synchronisierungspartners eines Geräts. Dies ist ein Gerät, eine Anwendung oder ein Server, mit dem das Gerät kommuniziert, um einen gemeinsamen Zustand oder eine Gruppe von Dateien zwischen beiden Partnern aufrechtzuerhalten. Beispiele hierfür sind E-Mail-Programme und Musikbibliotheken. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Ein -Wert, der den vom Benutzer auf dem Gerät festgelegten Anzeigenamen darstellt. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | der vom Gerät unterstützte Transport, z. B. USB, IP oder Bluetooth. Gültige Werte sind vom WPD_DEVICE_TRANSPORTS Enumerationstyp. |
| WPD_DEVICE_TYPE | VT_UI4 | Ein -Wert, der den Gerätetyp angibt; -Anwendungen verwenden diese Eigenschaft nur zu Darstellungszwecken. Funktionale Merkmale des Geräts werden durch funktionale Objekte bestimmt. Geräte, die kein Gerätesymbol bereitstellen, z. B. eine WPD_RESOURCE_ICON für das Geräteobjekt, werden im WPD-Namespace mit einem generischen Symbol dargestellt. Dieses Symbol hängt vom angegebenen Gerätetyp ab, z. B. wenn der Gerätetyp ein Mobiltelefon ist, wird das generische Telefonsymbol verwendet. Bei der ersten Installation des Geräts fragt der WPD-Klasseninstaller diesen Eigenschaftswert ab und speichert ihn in der Geräteregistrierung unter dem wert PORTABLE_DEVICE_TYPE als REG_DWORD. Die möglichen Werte dieses Parameters stammen aus der in PortableDevice.h definierten WPD_DEVICE_TYPES-Enumeration . Gültige Werte:
WPD_DEVICE_TYPE_CAMERA WPD_DEVICE_TYPE_MEDIA_PLAYER WPD_DEVICE_TYPE_PHONE WPD_DEVICE_TYPE_VIDEO WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER WPD_DEVICE_TYPE_AUDIO_RECORDER |
| WPD_DEVICE_USE_DEVICE_STAGE | VT_BOOL | Wenn diese Eigenschaft vorhanden ist und auf TRUE festgelegt ist, kann das Gerät mit Device Stage verwendet werden. Dies ist für Geräte gedacht, die keine Metadaten mithilfe des Gerätemetadatendiensts speichern können, aber Metadaten auf den Microsoft-Servern bereitstellen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|