HidDevice.FromIdAsync(String, FileAccessMode) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Apre un handle al dispositivo identificato dal parametro deviceId . Il tipo di accesso viene specificato dal parametro 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)
Parametri
- deviceId
-
String
Platform::String
winrt::hstring
ID DeviceInformation che identifica il dispositivo HID.
- accessMode
- FileAccessMode
Specifica la modalità di accesso. Le modalità di accesso supportate sono Read e ReadWrite.
Restituisce
Oggetto HidDevice . Se le funzionalità del dispositivo HID sono assenti o non corrette, questo sarà null
.
- Attributi
Commenti
La prima volta che questo metodo viene richiamato da un'app dello Store, deve essere chiamato da un thread dell'interfaccia utente per visualizzare il prompt del consenso. Dopo che l'utente ha concesso il consenso, il metodo può essere richiamato da qualsiasi thread dell'applicazione.
Il manifesto dell'applicazione deve dichiarare le funzionalità del dispositivo HID prima di richiamare questo metodo. Se le funzionalità del dispositivo HID sono mancanti o non specificate correttamente, il valore null
restituito sarà e non verrà generata alcuna eccezione.
Il dispositivo deve essere aperto con FileAccessMode.ReadWrite per chiamare SendOutputReportAsync o la chiamata avrà esito negativo con un'eccezione System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)
. Per chiamare SendFeatureReportAsync, GetFeatureReportAsync o GetInputReportAsync, il dispositivo deve essere aperto con FileAccessMode.Read o FileAccessMode.ReadWrite