HidDevice.FromIdAsync(String, FileAccessMode) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 です。
戻り値
HidDevice オブジェクト。 HID デバイスの機能がない場合、または正しくない場合、これは になります null
。
- 属性
注釈
このメソッドをストア アプリによって初めて呼び出す場合は、同意プロンプトを表示するために UI スレッドから呼び出す必要があります。 ユーザーが同意を与えた後、任意のアプリケーション スレッドから メソッドを呼び出すことができます。
このメソッドを呼び出す前に、アプリケーション マニフェストで HID デバイス機能を宣言する必要があります。 HID デバイスの機能がない場合、または正しく指定されていない場合、返される値は になり null
、例外はスローされません。
SendOutputReportAsync を呼び出すには、FileAccessMode.ReadWrite でデバイスを開く必要があります。または、呼び出しが例外でSystem.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)
失敗します。 SendFeatureReportAsync、GetFeatureReportAsync、または GetInputReportAsync を呼び出すには、FileAccessMode.Read または FileAccessMode.ReadWrite でデバイスを開く必要があります