HidDevice.FromIdAsync(String, FileAccessMode) Methode

Referenz

Definition

Namespace:: Windows.Devices.HumanInterfaceDevice

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.

Bearbeiten

Ö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

IAsyncOperation<HidDevice>

Ein HidDevice-Objekt . Wenn HID-Gerätefunktionen fehlen oder falsch sind, lautet nulldies .

Attribute: RemoteAsyncAttribute

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.

Gilt für: