Metode IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)

Artikel
03/01/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode RetrieveUsbInterface mengambil antarmuka USB yang ditentukan untuk perangkat USB.

Sintaks

HRESULT RetrieveUsbInterface(
  [in]  UCHAR            InterfaceIndex,
  [out] IWDFUsbInterface **ppUsbInterface
);

Parameter

[in] InterfaceIndex

Indeks antarmuka yang akan diambil.

[out] ppUsbInterface

Penunjuk ke variabel yang menerima penunjuk ke antarmuka IWDFUsbInterface yang ditentukan untuk perangkat USB.

Nilai kembali

RetrieveUsbInterface mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	RetrieveUsbInterface berhasil mengambil antarmuka USB yang ditentukan untuk perangkat USB.
E_OUTOFMEMORY	RetrieveUsbInterface mengalami kegagalan alokasi.
Kode kesalahan yang ditentukan dalam Winerror.h	Nilai ini sesuai dengan kode kesalahan yang dikembalikan API WinUsb.

Keterangan

Driver dapat memanggil metode IWDFUsbTargetDevice::GetNumInterfaces untuk mengambil jumlah total antarmuka USB yang tersedia.

Driver dapat menggunakan penunjuk antarmuka yang diambil RetrieveUsbInterface , untuk memanggil metode yang disediakan antarmuka IWDFUsbInterface . Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Bekerja dengan Antarmuka USB di UMDF.

Contoh

Untuk contoh kode tentang cara menggunakan metode RetrieveUsbInterface , lihat IWDFUsbTargetFactory::CreateUsbTargetDevice.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfusb.h (termasuk Wudfusb.h)
DLL	WUDFx.dll