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
Идентификатор DeviceInformation , идентифицирующий устройство HID.
- accessMode
- FileAccessMode
Указывает режим доступа. Поддерживаются режимы доступа Read и ReadWrite.
Возвращаемое значение
Объект HidDevice . Если возможности устройства HID отсутствуют или неверны, это будет nullзначение .
- Атрибуты
Комментарии
При первом вызове этого метода приложением Магазина он должен вызываться из потока пользовательского интерфейса, чтобы отобразить запрос на согласие. После предоставления согласия пользователь может вызывать метод из любого потока приложения.
Манифест приложения должен объявить возможности устройства HID перед вызовом этого метода. Если возможности устройства HID отсутствуют или указаны неправильно, возвращенное значение будет null равно и исключение не будет создано.
Чтобы вызвать SendOutputReportAsync, устройство должно быть открыто с помощью FileAccessMode.ReadWrite, в противном случае вызов завершится ошибкой System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) с исключением. Чтобы вызвать SendFeatureReportAsync, GetFeatureReportAsync или GetInputReportAsync, устройство должно быть открыто с помощью fileAccessMode.Read или FileAccessMode.ReadWrite.