Fungsi WdfUsbTargetDeviceGetInterface (wdfusb.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbTargetDeviceGetInterface mengembalikan handel ke objek antarmuka USB kerangka kerja yang terkait dengan indeks antarmuka tertentu.

Sintaks

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Parameter

[in] UsbDevice

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

[in] InterfaceIndex

Nilai indeks berbasis nol yang menentukan objek antarmuka USB dalam konfigurasi saat ini. Nilai indeks ini mungkin tidak sama dengan nomor antarmuka yang ditentukan spesifikasi USB.

Nilai kembali

WdfUsbTargetDeviceGetInterface mengembalikan handel ke objek antarmuka USB. Jika nilai InterfaceIndex tidak valid, metode ini mengembalikan NULL.

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

Keterangan

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

Contoh

Contoh kode berikut mendapatkan handel ke objek antarmuka USB pertama yang telah dibuat kerangka kerja untuk perangkat USB. Contoh kemudian mendapatkan jumlah titik akhir yang terkait dengan objek antarmuka.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

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	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

WdfUsbTargetDeviceCreateWithParameters