Metode IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)
[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 |
---|---|
|
RetrieveUsbInterface berhasil mengambil antarmuka USB yang ditentukan untuk perangkat USB. |
|
RetrieveUsbInterface mengalami kegagalan alokasi. |
|
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 |