DeviceInformation.CreateFromIdAsync メソッド

リファレンス

定義

名前空間:: Windows.Devices.Enumeration

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

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。

戻り値

IAsyncOperation<DeviceInformation>

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

属性: OverloadAttribute RemoteAsyncAttribute

例

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

// 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>)

適用対象

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 プロパティに含める追加のプロパティのリスト。プロパティが表す内容の詳細については、「デバイス情報のプロパティ」を参照してください。

戻り値

IAsyncOperation<DeviceInformation>

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

属性: OverloadAttribute

例

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

// 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)

適用対象

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>

kind: DeviceInformationKind

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

戻り値

IAsyncOperation<DeviceInformation>

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

属性: OverloadAttribute

こちらもご覧ください

適用対象

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>

kind: DeviceInformationKind

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

settings: IDeviceEnumerationSettings

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

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

戻り値

IAsyncOperation<DeviceInformation>

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

属性: OverloadAttribute

Windows の要件

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

適用対象

次の方法で共有

DeviceInformation.CreateFromIdAsync メソッド

定義

オーバーロード

CreateFromIdAsync(String)

パラメーター

戻り値

例

こちらもご覧ください

適用対象

CreateFromIdAsync(String, IIterable<String>)

パラメーター

戻り値

例

こちらもご覧ください

適用対象

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

パラメーター

戻り値

こちらもご覧ください

適用対象

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

パラメーター

戻り値

Windows の要件

適用対象

フィードバック

その他のリソース