Partager via


HidDevice.FromIdAsync(String, FileAccessMode) Méthode

Définition

Ouvre un handle sur l’appareil identifié par le paramètre deviceId . Le type d’accès est spécifié par le paramètre 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)

Paramètres

deviceId
String

Platform::String

winrt::hstring

ID DeviceInformation qui identifie l’appareil HID.

accessMode
FileAccessMode

Spécifie le mode d’accès. Les modes d’accès pris en charge sont Read et ReadWrite.

Retours

Objet HidDevice . Si les fonctionnalités de l’appareil HID sont absentes ou incorrectes, il s’agit de null.

Attributs

Remarques

La première fois que cette méthode est appelée par une application du Store, elle doit être appelée à partir d’un thread d’interface utilisateur afin d’afficher l’invite de consentement. Une fois que l’utilisateur a accordé son consentement, la méthode peut être appelée à partir de n’importe quel thread d’application.

Le manifeste d’application doit déclarer les fonctionnalités d’appareil HID avant d’appeler cette méthode. Si les fonctionnalités de l’appareil HID sont manquantes ou spécifiées de manière incorrecte, la valeur retournée est null et aucune exception n’est levée.

L’appareil doit être ouvert avec FileAccessMode.ReadWrite pour appeler SendOutputReportAsync , sinon l’appel échoue avec une System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) exception. Pour appeler SendFeatureReportAsync, GetFeatureReportAsync ou GetInputReportAsync, l’appareil doit être ouvert avec FileAccessMode.Read ou FileAccessMode.ReadWrite

S’applique à

Voir aussi