HidDevice.FromIdAsync(String, FileAccessMode) 方法

定义

打开由 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。

返回

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

属性

注解

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

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

必须使用 FileAccessMode.ReadWrite 打开设备才能调用 SendOutputReportAsync ,否则调用将失败并出现 System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) 异常。 若要调用 SendFeatureReportAsyncGetFeatureReportAsyncGetInputReportAsync,必须使用 FileAccessMode.ReadFileAccessMode.ReadWrite 打开设备

适用于

另请参阅