Share via


HidDevice.FromIdAsync(String, FileAccessMode) Metodo

Definizione

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

Si applica a

Vedi anche