WdfUsbTargetDeviceGetDeviceDescriptor-Funktion (wdfusb.h)

[Gilt für KMDF und UMDF]

Die WdfUsbTargetDeviceGetDeviceDescriptor Methode ruft den USB-Gerätedeskriptor für das USB-Gerät ab, das einem angegebenen Framework-USB-Geräteobjekt zugeordnet ist.

Syntax

VOID WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

Parameter

[in] UsbDevice

Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParametersabgerufen wurde.

[out] UsbDeviceDescriptor

Ein Zeiger auf eine vom Aufrufer zugewiesene USB_DEVICE_DESCRIPTOR Struktur, die den USB-Gerätedeskriptor empfängt.

Rückgabewert

Nichts

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn ein vom Treiber bereitgestelltes Objekthandle ungültig ist.

Weitere Informationen zu den WdfUsbTargetDeviceGetDeviceDescriptor Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Im folgenden Codebeispiel wird der USB-Gerätedeskriptor für ein Gerät abgerufen. Im Beispiel wird der Deskriptor im vom Treiber definierten Kontextbereich gespeichert.

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

WdfUsbTargetDeviceGetDeviceDescriptor(
                                      myDeviceContext->UsbTargetDevice,
                                      &myDeviceContext->UsbDeviceDescr
                                      );

Anforderungen

Siehe auch

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters