HidDevice.FromIdAsync(String, FileAccessMode) メソッド

定義

名前空間:

Windows.Devices.HumanInterfaceDevice

deviceId パラメーターで識別されるデバイスへのハンドルを開きます。 アクセスの種類は、 accessMode パラメーターによって指定されます。

public:
 static IAsyncOperation<HidDevice ^> ^ FromIdAsync(Platform::String ^ deviceId, FileAccessMode accessMode);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<HidDevice> FromIdAsync(winrt::hstring const& deviceId, FileAccessMode const& accessMode);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<HidDevice> FromIdAsync(string deviceId, FileAccessMode accessMode);

function fromIdAsync(deviceId, accessMode)

Public Shared Function FromIdAsync (deviceId As String, accessMode As FileAccessMode) As IAsyncOperation(Of HidDevice)

パラメーター

deviceId

String

Platform::String

winrt::hstring

HID デバイスを識別する DeviceInformation ID。

accessMode

FileAccessMode

アクセス モードを指定します。 サポートされているアクセス モードは、読み取りと ReadWrite です。

戻り値

IAsyncOperation<HidDevice>

HidDevice オブジェクト。 HID デバイスの機能がない場合、または正しくない場合、これは になります null。

属性

RemoteAsyncAttribute

注釈

このメソッドをストア アプリによって初めて呼び出す場合は、同意プロンプトを表示するために UI スレッドから呼び出す必要があります。 ユーザーが同意を与えた後、任意のアプリケーション スレッドから メソッドを呼び出すことができます。

このメソッドを呼び出す前に、アプリケーション マニフェストで HID デバイス機能を宣言する必要があります。 HID デバイスの機能がない場合、または正しく指定されていない場合、返される値は になり null 、例外はスローされません。

SendOutputReportAsync を呼び出すには、FileAccessMode.ReadWrite でデバイスを開く必要があります。または、呼び出しが例外でSystem.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)失敗します。 SendFeatureReportAsync、GetFeatureReportAsync、または GetInputReportAsync を呼び出すには、FileAccessMode.Read または FileAccessMode.ReadWrite でデバイスを開く必要があります

こちらもご覧ください

• Windows.Devices.HumanInterfaceDevice
• カスタム HID デバイスのサンプル