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

Идентификатор DeviceInformation , идентифицирующий устройство HID.

accessMode
FileAccessMode

Указывает режим доступа. Поддерживаются режимы доступа Read и ReadWrite.

Возвращаемое значение

IAsyncOperation<HidDevice>

Объект HidDevice . Если возможности устройства HID отсутствуют или неверны, это будет nullзначение .

Атрибуты
RemoteAsyncAttribute

Комментарии

При первом вызове этого метода приложением Магазина он должен вызываться из потока пользовательского интерфейса, чтобы отобразить запрос на согласие. После предоставления согласия пользователь может вызывать метод из любого потока приложения.

Манифест приложения должен объявить возможности устройства HID перед вызовом этого метода. Если возможности устройства HID отсутствуют или указаны неправильно, возвращенное значение будет null равно и исключение не будет создано.

Чтобы вызвать SendOutputReportAsync, устройство должно быть открыто с помощью FileAccessMode.ReadWrite, в противном случае вызов завершится ошибкой System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) с исключением. Чтобы вызвать SendFeatureReportAsync, GetFeatureReportAsync или GetInputReportAsync, устройство должно быть открыто с помощью fileAccessMode.Read или FileAccessMode.ReadWrite.

Применяется к

См. также раздел