UsbDevice Klasse

Definition

public ref class UsbDevice sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UsbDevice final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UsbDevice : System.IDisposable

Public NotInheritable Class UsbDevice
Implements IDisposable

Vererbung

Object Platform::Object IInspectable UsbDevice

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Beispiele

Dieser Beispielcode zeigt, wie Sie das UsbDevice-Objekt abrufen, indem Sie die Anbieter-/Produkt-ID angeben.

protected override async void OnLaunched(LaunchActivatedEventArgs args)
{
    UInt32 vid = 0x045E;
    UInt32 pid = 0x078F;

    string aqs = UsbDevice.GetDeviceSelector(vid, pid);

    var myDevices = await Windows.Devices.Enumeration.DeviceInformation.FindAllAsync(aqs, null);

    if (myDevices.Count == 0)
    {
        ShowError("Device not found!");
        return;
    }

    UsbDevice device = await UsbDevice.FromIdAsync(myDevices[0].Id);

    // Send a control transfer. 

    UsbSetupPacket initSetupPacket = new UsbSetupPacket() 
    { 
        Request = initRequest,
        RequestType = new UsbControlRequestType()
        {
            Recipient = UsbControlRecipient.DefaultInterface,

            ControlTransferType = UsbControlTransferType.Vendor 
        }
    };

   await device.SendOutControlTransferAsync(initSetupPacket);
}

Hinweise

Bevor Sie einen Verweis auf das UsbDevice-Objekt erhalten, benötigen Sie einen der folgenden Bezeichner:

• Die Anbieter- und Produkt-IDs für das physische Gerät. Diese Bezeichner sind Teil der Hardware-ID-Zeichenfolge. Alternativ können Sie die Bezeichner von der Eigenschaft Hardware-IDs in Geräte-Manager ableiten. Wenn die Hardware-ID beispielsweise lautet, lautet USB\VID_045E&PID_078E0x045E die Anbieter-ID und die Produkt-ID 0x078E.
• Die GUID der Geräteschnittstelle. Sie können diese GUID aus dem Registrierungseintrag DeviceInterfaceGuids abrufen unter: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Enum\USB Device\<Identifier>\<Instance Identifier>\Device Parameters
• Die Klassen-, Unterklassen- und Protokollcodes des Geräts. Sie können diese Informationen aus dem Registrierungseintrag CompatibleIds abrufen, der sich unter dem Geräteparameterschlüssel befindet.

So rufen Sie das UsbDevice-Objekt ab:

1. Rufen Sie die AQS-Zeichenfolge (Advanced Query Syntax) ab, die Suchkriterien für die Suche nach dem Gerät in der aufgezählten Gerätesammlung enthält. Wenn Sie nach der Anbieter-ID/Produkt-ID oder der Geräteschnittstellen-GUID suchen möchten, rufen Sie GetDeviceSelector auf. Wenn Sie nach der Geräteklasse suchen möchten, rufen Sie GetDeviceClassSelector auf. Beide Aufrufe rufen formatierte AQS-Zeichenfolgen ab.
2. Übergeben Sie die abgerufene Zeichenfolge an FindAllAsync. Der Aufruf ruft ein DeviceInformationCollection-Objekt ab.
3. Durchlaufen Sie die Auflistung. Jede Iteration ruft ein DeviceInformation-Objekt ab.
4. Rufen Sie den Wert der DeviceInformation.Id-Eigenschaft ab. Der Zeichenfolgenwert ist der Pfad des Geräts instance. Beispiel: \\?\USB#VID_045E&PID_078F#6&1b8ff026&0&5#{dee824ef-729b-4a0e-9c14-b7117d33a817}.
5. Rufen Sie FromIdAsync auf, indem Sie die instance Zeichenfolge des Geräts übergeben und das UsbDevice-Objekt abrufen. Anschließend können Sie das UsbDevice-Objekt verwenden, um andere Vorgänge auszuführen, z. B. das Senden einer Steuerungsübertragung. Wenn die App die Verwendung des UsbDevice-Objekts abgeschlossen hat, muss es von der App durch Aufrufen von Close freigegeben werden.

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Beispiel für ein benutzerdefiniertes USB-Gerät (Windows 10)