HidDevice.FromIdAsync(String, FileAccessMode) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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