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

指定访问模式。 支持的访问模式为 Read 和 ReadWrite。

返回

IAsyncOperation<HidDevice>

HidDevice 对象。 如果 HID 设备功能缺失或不正确，则为 null。

属性

RemoteAsyncAttribute

注解

应用商店应用首次调用此方法时，应从 UI 线程调用此方法，以显示同意提示。 在用户授予许可后，可以从任何应用程序线程调用 方法。

在调用此方法之前，应用程序清单必须声明 HID 设备功能。 如果 HID 设备功能缺失或未正确指定，则返回的值将为 null ，并且不会引发异常。

必须使用 FileAccessMode.ReadWrite 打开设备才能调用 SendOutputReportAsync ，否则调用将失败并出现 System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) 异常。 若要调用 SendFeatureReportAsync、GetFeatureReportAsync 或 GetInputReportAsync，必须使用 FileAccessMode.Read 或 FileAccessMode.ReadWrite 打开设备

另请参阅

• Windows.Devices.HumanInterfaceDevice
• 自定义 HID 设备示例