HidDevice.FromIdAsync(String, FileAccessMode) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Abre un identificador para el dispositivo identificado por el parámetro deviceId . El parámetro accessMode especifica el tipo de acceso.
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
Identificador deviceInformation que identifica el dispositivo HID.
- accessMode
- FileAccessMode
Especifica el modo de acceso. Los modos de acceso admitidos son Read y ReadWrite.
Devoluciones
Objeto HidDevice . Si las funcionalidades del dispositivo HID no están presentes o son incorrectas, será null
.
- Atributos
Comentarios
La primera vez que una aplicación de la tienda invoca este método, se debe llamar desde un subproceso de interfaz de usuario para mostrar el mensaje de consentimiento. Una vez que el usuario haya concedido consentimiento, se puede invocar el método desde cualquier subproceso de aplicación.
El manifiesto de aplicación debe declarar las funcionalidades del dispositivo HID antes de invocar este método. Si faltan funcionalidades del dispositivo HID o se especifican incorrectamente, el valor devuelto será null
y no se producirá ninguna excepción.
El dispositivo debe abrirse con FileAccessMode.ReadWrite para llamar a SendOutputReportAsync o se producirá un error en la llamada con una System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)
excepción. Para llamar a SendFeatureReportAsync, GetFeatureReportAsync o GetInputReportAsync, el dispositivo debe abrirse con FileAccessMode.Read o FileAccessMode.ReadWrite.