HidDevice.FromIdAsync(String, FileAccessMode) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Öffnet ein Handle für das Gerät, das durch den deviceId-Parameter identifiziert wird. Der Zugriffstyp wird durch den accessMode-Parameter angegeben.
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)Parameter
- deviceId
-
String
Platform::String
winrt::hstring
Die DeviceInformation-ID , die das HID-Gerät identifiziert.
- accessMode
- FileAccessMode
Gibt den Zugriffsmodus an. Die unterstützten Zugriffsmodi sind Read und ReadWrite.
Gibt zurück
Ein HidDevice-Objekt . Wenn HID-Gerätefunktionen fehlen oder falsch sind, lautet nulldies .
- Attribute
Hinweise
Wenn diese Methode zum ersten Mal von einer Store-App aufgerufen wird, sollte sie aus einem UI-Thread aufgerufen werden, um die Zustimmungsaufforderung anzuzeigen. Nachdem der Benutzer seine Zustimmung erteilt hat, kann die -Methode aus einem beliebigen Anwendungsthread aufgerufen werden.
Das Anwendungsmanifest muss HID-Gerätefunktionen deklarieren, bevor diese Methode aufgerufen wird. Wenn HID-Gerätefunktionen fehlen oder falsch angegeben sind, wird der zurückgegebene Wert zurückgegeben null , und es wird keine Ausnahme ausgelöst.
Das Gerät muss mit FileAccessMode.ReadWrite geöffnet werden, um SendOutputReportAsync aufzurufen, andernfalls schlägt der Aufruf mit einer Ausnahme fehl System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005) . Um SendFeatureReportAsync, GetFeatureReportAsync oder GetInputReportAsync aufzurufen, muss das Gerät entweder mit FileAccessMode.Read oder FileAccessMode.ReadWrite geöffnet werden.