Device Properties (PortableDevice.h)
Windows 可攜式裝置支援下列裝置屬性。
屬性 | VarType | Description |
---|---|---|
WPD_DEVICE_DATETIME | VT_DATE | 裝置上的目前日期和時間。 |
WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | 裝置的韌體版本。 |
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR |VT_UI1 | 裝置所支援之多個傳輸之間通用的唯一 16 位元組識別碼。 如果單一裝置支援多個傳輸,則此屬性可用來將各種傳輸 WPD 驅動程式與該裝置產生關聯。 |
WPD_DEVICE_MANUFACTURER | VT_LPWSTR | 人類可讀取的裝置製造商名稱。 |
WPD_DEVICE_MODEL | VT_LPWSTR | 裝置型號。 |
WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR |VT_UI1 | 用來區分不同裝置型號的唯一 16 位元組識別碼。 |
WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | 值,指定裝置的 EUI-64 網路識別碼;這個屬性用於頻外網路作業。如果裝置的 MAC-48 實體網路位址 (IPv4 網路一般) ,MAC-48 位址會以 EUI-64 位址編碼為 FF-FF-FF 分隔之 MAC-48 位址的兩半。 EUI-64 值會以「網路」或「大端」順序儲存,其中 EUI-64 位址為 01-02-03-FF-FF-04-05-06 會放在VT_UI8中,讓小數值72624942021346566。 支援「小名」或「安全驗證」的任何裝置上都需要此屬性。 僅支援零驗證的裝置上建議使用這個屬性。 主機可以使用此值來自動建立裝置的存取權,而不需要使用者介入。 |
WPD_DEVICE_POWER_LEVEL | VT_UI4 | 從 0 到 100 的值,指定裝置電池的電源等級,0 為無,且完全充電 100。 |
WPD_DEVICE_POWER_SOURCE | VT_UI4 | 指定裝置電源的 WPD_POWER_SOURCES 列舉。 |
WPD_DEVICE_PROTOCOL | VT_LPWSTR | 正在使用的裝置通訊協定。 |
WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | 裝置的序號。 |
WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | 值,指定從裝置傳回的支援格式是否為慣用順序。 裝置最偏好清單中的第一個格式,而最後一個格式是最不慣用的格式。應用程式可以使用這個屬性來判斷裝置支援的格式是否以慣用的順序列出。 |
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | 布林值,指定從裝置傳回的支援格式是否為慣用順序;也就是說,第一個傳回的格式最慣用,而最後一個傳回的格式最不慣用。 |
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | 布林值,指定裝置是否支援非消費性物件。 這些是裝置只用來儲存的物件,不會以任何方式播放或使用。 |
WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | 裝置 同步處理合作夥伴的人類可讀描述。 這是裝置與裝置通訊的裝置、應用程式或伺服器,可維護兩個夥伴之間的一般狀態或檔案群組。 範例包括電子郵件程式和音樂媒體櫃。 |
WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | 值,表示裝置上使用者所設定的易記名稱。 |
WPD_DEVICE_TRANSPORT | VT_UI4 | 裝置支援的傳輸,例如 USB、IP 或藍牙。 有效值為 WPD_DEVICE_TRANSPORTS 列舉類型。 |
WPD_DEVICE_TYPE | VT_UI4 | 指定裝置類型的 值;應用程式僅針對表示用途使用這個屬性。 裝置的功能特性是透過功能物件來決定。未提供裝置圖示的裝置,例如裝置物件的 WPD_RESOURCE_ICON ,將會以一般圖示在 WPD 命名空間中表示。 此圖示將取決於指定的裝置類型,例如,如果裝置類型是行動電話,則會使用一般手機圖示。 在第一次安裝裝置時,WPD 類別安裝程式會查詢這個屬性值,並將其儲存在裝置登錄的 PORTABLE_DEVICE_TYPE 值之下,作為REG_DWORD。 此參數的可能值來自 PortableDevice.h 中定義的 WPD_DEVICE_TYPES 列舉。 值為:
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 | 如果此屬性存在且設定為 TRUE,則裝置可以搭配裝置階段使用。 這適用于無法使用 裝置中繼資料服務來儲存中繼資料,但會在 Microsoft 伺服器上提供中繼資料的裝置。 |
規格需求
需求 | 值 |
---|---|
標頭 |
|