Fungsi WdfUsbTargetDeviceGetDeviceDescriptor (wdfusb.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbTargetDeviceGetDeviceDescriptor mengambil deskriptor perangkat USB untuk perangkat USB yang terkait dengan objek perangkat USB kerangka kerja tertentu.

Sintaks

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

Parameter

[in] UsbDevice

Handel ke objek perangkat USB yang diperoleh dari panggilan sebelumnya ke WdfUsbTargetDeviceCreateWithParameters.

[out] UsbDeviceDescriptor

Penunjuk ke struktur USB_DEVICE_DESCRIPTOR yang dialokasikan penelepon yang menerima deskriptor perangkat USB.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika handel objek yang disediakan driver tidak valid.

Untuk informasi selengkapnya tentang metode WdfUsbTargetDeviceGetDeviceDescriptor dan target I/O USB, lihat Target I/O USB.

Contoh

Contoh kode berikut mendapatkan pendeskripsi perangkat USB untuk perangkat. Contoh menyimpan deskriptor dalam ruang konteks yang ditentukan driver.

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfusb.h (termasuk Wdfusb.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters