HidDevice.FromIdAsync(String, FileAccessMode) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um objeto HidDevice . Se os recursos do dispositivo HID estiverem ausentes ou incorretos, isso será null.
- Atributos
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