Metode IWDFUsbInterface::RetrieveUsbPipeObject (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 RetrieveUsbPipeObject mengambil objek pipa USB untuk indeks pipa yang ditentukan.

Sintaks

HRESULT RetrieveUsbPipeObject(
  [in]  UCHAR             PipeIndex,
  [out] IWDFUsbTargetPipe **ppPipe
);

Parameter

[in] PipeIndex

Indeks objek pipa USB yang akan diambil.

[out] ppPipe

Pointer ke variabel yang menerima pointer ke antarmuka IWDFUsbTargetPipe untuk objek pipa USB yang indeksnya ditentukan oleh PipeIndex.

Nilai kembali

RetrieveUsbPipeObject mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	RetrieveUsbPipeObject berhasil mengambil objek pipa USB.
E_OUTOFMEMORY	RetrieveUsbPipeObject mengalami kegagalan alokasi.
Kode kesalahan yang didefinisikan dalam Winerror.h	Nilai ini sesuai dengan kode kesalahan yang dikembalikan API WinUsb.

Keterangan

Driver UMDF dapat memanggil metode antarmuka IWDFUsbTargetPipe yang diambil metode RetrieveUsbPipeObject untuk mendapatkan jenis pipa dan informasi lainnya.

Contoh

Untuk contoh kode tentang cara menggunakan metodeRetrieveUsbPipeObject , lihat IWDFUsbInterface::GetNumEndPoints.

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

Lihat juga

IWDFUsbInterface

IWDFUsbTargetPipe