Funzione WdfUsbTargetDeviceGetDeviceDescriptor (wdfusb.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfUsbTargetDeviceGetDeviceDescriptor recupera il descrittore del dispositivo USB per il dispositivo USB associato a un oggetto dispositivo USB del framework specificato.

Sintassi

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

Parametri

[in] UsbDevice

Handle per un oggetto dispositivo USB ottenuto da una chiamata precedente a WdfUsbTargetDeviceCreateWithParameters.

[out] UsbDeviceDescriptor

Puntatore a una struttura di USB_DEVICE_DESCRIPTOR allocata dal chiamante che riceve il descrittore del dispositivo USB.

Valore restituito

Nessuno

Osservazioni

Se un handle di oggetto fornito dal driver non è valido, viene verificato un controllo di bug.

Per altre informazioni sul metodo di WdfUsbTargetDeviceGetDeviceDescriptor e sulle destinazioni di I/O USB, vedere Destinazioni I/O USB.

Esempi

L'esempio di codice seguente ottiene il descrittore di dispositivo USB per un dispositivo. L'esempio archivia il descrittore nello spazio di contesto definito dal driver.

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfusb.h (include Wdfusb.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedere anche

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters

Condividi tramite