如何抓取裝置或 PnP 物件的其他屬性 (HTML)

[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App，請參閱 最新文件 ]

描述如何從 DeviceInformation 或 PnpObject 取得其他裝置屬性。

指定其他屬性

根據預設，findAllAsync 和 createWatcher 會傳回具有下列屬性的 DeviceInformation 物件：

屬性	正式名稱
識別碼	不適用。這個屬性是物件的身分識別。
名稱	System.ItemNameDisplay
IsDefault	System.Devices.IsDefault
IsEnabled	System.Devices.InterfaceEnabled
EnclosureLocation	System.Devices.PhysicalDeviceLocation

 

您可以使用 DeviceInformation 和 PnpObject 類別提供的 findAllAsync 和 createWatcher 方法多載格式。您可以使用 additionalProperties 參數指定結果中要包含的其他屬性，如下所示。

// Create a set of two additional properties.
    var propertiesToRetrieve = new Array();
    propertiesToRetrieve.push("System.Devices.InterfaceClassGuid");
    propertiesToRetrieve.push("System.Devices.ContainerId");

    Windows.Devices.Enumeration.findAllAsync(selectorString, 
             propertiesToRetrieve).then(successCallback, errorCallback);)

// Handles successful completion of the findAllAsync method.
function successCallback(deviceInformationCollection) {
    var numDevices = deviceInformationCollection.length;
    if (numDevices) {
        for (var i = 0; i < numDevices; i++) {
            printProperties(document.getElementById("log"),
                 deviceInformationCollection[i].properties);
        }
    } 
}

// Handles an error completion of the findAllAsync method.
function errorCallback(e) {
    document.getElementById("statusMessage").innerHTML = 
        "Failed to find devices, error: " + e.message;
}

function printProperties(log, prop) {
    log.innerHTML += "property store count is: " + prop.size;
    var pt = prop.first();
    while (pt.hasCurrent) {
        log.innerHTML += "<br />" + pt.current.key + " := " + pt.current.value;
        pt.moveNext();
    }
    log.innerHTML += "<br />";
}

屬性正式名稱清單

如果屬性值沒有與特定裝置介面關聯，它可能會與介面所屬的裝置關聯，或是與代表裝置硬體產品可見部分 (如製造商或型號名稱) 的裝置容器物件關聯。 下列是裝置介面、裝置以及裝置容器的屬性名稱清單。如需了解如何在物件類型之間瀏覽，請參閱抓取相關的 PnP 物件。

裝置介面屬性

名稱	屬性	說明
System.Devices.ContainerId	DEVPKEY_Device_ContainerId	裝置介面容器的識別碼。
System.Devices.DeviceInstanceId	DEVPKEY_Device_InstanceId	這個介面所屬裝置的裝置執行個體識別碼。
System.Devices.InterfaceClassGuid	DEVPKEY_DeviceInterface_ClassGuid	介面的類別 GUID。
System.Devices.InterfaceEnabled	DEVPKEY_DeviceInterface_Enabled	指示是否啟用介面。
System.ItemNameDisplay	DEVPKEY_NAME	裝置介面的易記名稱。
System.Storage.IsMediaRemovable	DEVPKEY_Storage_Removable_Media	指示磁碟區中的媒體是否可以移除。
System.Storage.IsPortable	DEVPKEY_Storage_Portable	指示存放裝置堆疊是否將存放裝置視為可攜式。

 

裝置屬性

名稱	屬性	說明
System.Devices.Children	DEVPKEY_Device_Children	子系的裝置執行個體識別碼。 從核心狀態即時查詢。
System.Devices.CompatibleIds	DEVPKEY_Device_CompatibleIds	這個屬性是 multi-sz 字串值，其中包含裝置的相容識別碼清單。
System.Devices.ContainerId	DEVPKEY_Device_ContainerId	裝置容器的識別碼。
System.Devices.DeviceCapabilities	DEVPKEY_Device_Capabilities	這個屬性是 DWORD 值，其中包含裝置功能的位元運算 OR。 這些功能由 cfgmgr32.h 中定義的 CM_DEVCAP_Xxxxx 位元遮罩所表示。
System.Devices.DeviceCharacteristics	DEVPKEY_Device_Characteristics	這個屬性是 DWORD 值，其中包含裝置特性的位元運算 OR。 如需在 wdm.h 和 ntddk.h 中定義的這些旗標說明，請參閱 IoCreateDevice 函式的 DeviceCharacteristics 參數。
System.Devices.DeviceHasProblem	DEVPKEY_Device_HasProblem	這個屬性會從核心狀態即時查詢。
System.Devices.DeviceInstanceId	DEVPKEY_Device_InstanceId	裝置執行個體識別碼。
System.Devices.HardwareIds	DEVPKEY_Device_HardwareIds	這個屬性是 multi-sz 字串值，其中包含裝置的硬體識別碼清單。
System.Devices.InLocalMachineContainer	DEVPKEY_Device_InLocalMachineContainerr	指示 devnode 是否在電腦的容器中。
System.ItemNameDisplay	DEVPKEY_NAME	裝置執行個體的名稱。

 

容器屬性

名稱	屬性和描述
System.ItemNameDisplay	PKEY_NAME - 容器的名稱。
System.Devices.DiscoveryMethod	DEVPKEY_DeviceContainer_DiscoveryMethod - 裝置探索方法清單。
System.Devices.Connected	DEVPKEY_DeviceContainer_IsConnected - 指示是否已連接裝置。
System.Devices.Paired	DEVPKEY_DeviceContainer_IsPaired - 指示裝置是否已配對。
System.Devices.Icon	DEVPKEY_DeviceContainer_Icon - 裝置圖示的路徑。
System.Devices.LocalMachine	DEVPKEY_DeviceContainer_IsLocalMachine - 這個容器是否代表本機電腦 (PC)。
System.Devices.MetadataPath	DEVPKEY_DeviceContainer_MetadataPath - 裝置中繼資料的路徑。
System.Devices.LaunchDeviceStageFromExplorer	DEVPKEY_DeviceContainer_LaunchDeviceStageFromExlplorer - 是否從 Windows 檔案總管啟動 Device Stage。
System.Devices.DeviceDescription1	DEVPKEY_DeviceContainer_DeviceDescription1 - 裝置描述。
System.Devices.DeviceDescription2	DEVPKEY_DeviceContainer_DeviceDescription2 - 裝置描述。
System.Devices.NotWorkingProperly	DEVPKEY_DeviceContainer_HasProblem - 容器是否有問題。如果容器中有任何裝置將 DEVPKEY_DEVICE_HasProblem 設為 TRUE，則為 TRUE。
System.Devices.IsShared	DEVPKEY_DeviceContainer_IsSharedDevice - 裝置是否為共用。
System.Devices.IsNetworkConnected	DEVPKEY_DeviceContainer_IsNetworkDevice - 裝置是否與網路連線。
System.Devices.IsDefault	DEVPKEY_DeviceContainer_IsDefaultDevice - 裝置是否為預設裝置。
System.Devices.Category	DEVPKEY_DeviceContainer_Category_Desc_Singular - 裝置類別 (單數)。
System.Devices.CategoryPlural	DEVPKEY_DeviceContainer_Category_Desc_Singular - 裝置類別 (複數)。
System.Devices.CategoryGroup	DEVPKEY_DeviceContainer_CategoryGroup_Desc - 裝置類別群組。
System.Devices.FriendlyName	DEVPKEY_DeviceContainer_FriendlyName - 易記名稱。
System.Devices.Manufacturer	DEVPKEY_DeviceContainer_Manufacturer - 製造商名稱。
System.Devices.ModelName	DEVPKEY_DeviceContainer_ModelName - 型號名稱。
System.Devices.ModelNumber	DEVPKEY_DeviceContainer_ModelNumber - 型號。

 

指定沒有正式名稱的屬性

當屬性沒有指定正式名稱時，只要將索引鍵指定為 "{Guid} pid" 格式的字串，還是可以抓取它。 例如，System.Devices.ContainerId 可以指定為 "{8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2"。

相關主題

概念

系統定義的裝置屬性

統一裝置屬性模式