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
指定访问模式。 支持的访问模式为 Read 和 ReadWrite。
返回
HidDevice 对象。 如果 HID 设备功能缺失或不正确,则为 null
。
- 属性
注解
应用商店应用首次调用此方法时,应从 UI 线程调用此方法,以显示同意提示。 在用户授予许可后,可以从任何应用程序线程调用 方法。
在调用此方法之前,应用程序清单必须声明 HID 设备功能。 如果 HID 设备功能缺失或未正确指定,则返回的值将为 null
,并且不会引发异常。
必须使用 FileAccessMode.ReadWrite 打开设备才能调用 SendOutputReportAsync ,否则调用将失败并出现 System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)
异常。 若要调用 SendFeatureReportAsync、GetFeatureReportAsync 或 GetInputReportAsync,必须使用 FileAccessMode.Read 或 FileAccessMode.ReadWrite 打开设备