DeviceInformation.CreateFromIdAsync メソッド

定義

オーバーロード

CreateFromIdAsync(String)

DeviceInformation ID から DeviceInformation オブジェクトを作成します。

CreateFromIdAsync(String, IIterable<String>)

DeviceInformation ID と追加のプロパティの一覧から DeviceInformation オブジェクトを作成します。

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

DeviceInformation ID、追加のプロパティの一覧、および DeviceInformationKind パラメーターから DeviceInformation オブジェクトを作成します。

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

DeviceInformation ID、追加プロパティの一覧、DeviceInformationKind、settings オブジェクトから DeviceInformation オブジェクトを非同期的に作成します。

CreateFromIdAsync(String)

DeviceInformation ID から DeviceInformation オブジェクトを作成します。

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId);
function createFromIdAsync(deviceId)
Public Shared Function CreateFromIdAsync (deviceId As String) As IAsyncOperation(Of DeviceInformation)

パラメーター

deviceId
String

Platform::String

winrt::hstring

デバイス ID。

戻り値

DeviceInformation オブジェクトの非同期作成を開始および管理するための オブジェクト。

属性

この例の savedId 変数は、前回使用した DeviceInformation オブジェクトの id プロパティから取得した、アプリケーションによって以前に保存された DeviceInformationID です。

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

こちらもご覧ください

適用対象

CreateFromIdAsync(String, IIterable<String>)

DeviceInformation ID と追加のプロパティの一覧から DeviceInformation オブジェクトを作成します。

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties);
function createFromIdAsync(deviceId, additionalProperties)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String)) As IAsyncOperation(Of DeviceInformation)

パラメーター

deviceId
String

Platform::String

winrt::hstring

DeviceInformation ID を含む文字列。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

列挙結果の DeviceInformation オブジェクトの Properties プロパティに含める追加のプロパティのリスト。 プロパティが表す内容の詳細については、「 デバイス情報のプロパティ」を参照してください。

戻り値

DeviceInformation オブジェクトの非同期作成を開始および管理するための オブジェクト。

属性

次の例では、DeviceInformation ID から作成する DeviceInformation オブジェクトに含めるプロパティの一覧を作成します。この例の savedId 変数は、前回使用した DeviceInformation オブジェクトの id プロパティから取得した、アプリケーションによって以前に保存された DeviceInformationID です。

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

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId, propertiesToRetrieve).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

こちらもご覧ください

適用対象

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

DeviceInformation ID、追加のプロパティの一覧、および DeviceInformationKind パラメーターから DeviceInformation オブジェクトを作成します。

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind);
function createFromIdAsync(deviceId, additionalProperties, kind)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As IAsyncOperation(Of DeviceInformation)

パラメーター

deviceId
String

Platform::String

winrt::hstring

DeviceInformation ID を含む文字列。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

列挙結果の DeviceInformation オブジェクトの Properties プロパティに含める追加のプロパティのリスト。 プロパティが表す内容の詳細については、「 デバイス情報のプロパティ」を参照してください。

kind
DeviceInformationKind

作成する DeviceInformation オブジェクトの種類。

戻り値

DeviceInformation オブジェクトの非同期作成を開始および管理するための オブジェクト。

属性

こちらもご覧ください

適用対象

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

DeviceInformation ID、追加プロパティの一覧、DeviceInformationKind、settings オブジェクトから DeviceInformation オブジェクトを非同期的に作成します。

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings ^ settings);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind, IDeviceEnumerationSettings const& settings);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings settings);
function createFromIdAsync(deviceId, additionalProperties, kind, settings)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind, settings As IDeviceEnumerationSettings) As IAsyncOperation(Of DeviceInformation)

パラメーター

deviceId
String

Platform::String

winrt::hstring

DeviceInformation ID を含む文字列。

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

列挙結果の DeviceInformation オブジェクトの Properties プロパティに含める追加のプロパティのリスト。 プロパティが表す内容の詳細については、「 デバイス情報のプロパティ」を参照してください。

kind
DeviceInformationKind

作成する DeviceInformation オブジェクトの種類。

settings
IDeviceEnumerationSettings

settings で渡される引数は、IDeviceEnumerationSettings を実装するオブジェクトです。それ以外の場合、オブジェクトは不透明なマーカー クラスです (つまり、パブリック プロパティやメソッドはありません)。 設定の目的は、標準の WDE API では不可能なデバイス固有のシナリオで、デバイス固有の API から拡張パラメーターを取得することです。 パラメーターは、API サーフェスで許可されていない追加のノブと考えることができます。

settings オブジェクトは、デバイス API の GetDeviceEnumerationSettings メソッドから取得され、不透明なデータが含まれます。 ただし、現在、 オブジェクトを生成する API はありません。

戻り値

完了すると、新しく作成された DeviceInformation オブジェクトを含む非同期操作オブジェクト。

属性

Windows の要件

デバイス ファミリ
Windows 11 Insider Preview (10.0.26100.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v19.0 で導入)

適用対象