HidDevice.FromIdAsync(String, FileAccessMode) Método

Definição

Namespace:

Windows.Devices.HumanInterfaceDevice

Abre um identificador para o dispositivo identificado pelo parâmetro deviceId . O tipo de acesso é especificado pelo parâmetro 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)

Parâmetros

deviceId

String

Platform::String

winrt::hstring

A ID de DeviceInformation que identifica o dispositivo HID.

accessMode

FileAccessMode

Especifica o modo de acesso. Os modos de acesso com suporte são Read e ReadWrite.

Retornos

IAsyncOperation<HidDevice>

Um objeto HidDevice . Se os recursos do dispositivo HID estiverem ausentes ou incorretos, isso será null.

Atributos

RemoteAsyncAttribute

Comentários

Na primeira vez que esse método é invocado por um aplicativo da loja, ele deve ser chamado de um thread de interface do usuário para exibir o prompt de consentimento. Depois que o usuário tiver concedido o consentimento, o método poderá ser invocado de qualquer thread de aplicativo.

O manifesto do aplicativo deve declarar as funcionalidades do dispositivo HID antes de invocar esse método. Se os recursos do dispositivo HID estiverem ausentes ou especificados incorretamente, o valor retornado será null e nenhuma exceção será gerada.

O dispositivo deve ser aberto com FileAccessMode.ReadWrite para chamar SendOutputReportAsync ou a chamada falhará com uma System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) exceção. Para chamar SendFeatureReportAsync, GetFeatureReportAsync ou GetInputReportAsync, o dispositivo deve ser aberto com FileAccessMode.Read ou FileAccessMode.ReadWrite

Confira também

• Windows.Devices.HumanInterfaceDevice
• Exemplo de dispositivo HID personalizado