Metode IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.h)

Artikel
02/27/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 RetrieveDeviceInformation mengambil informasi perangkat dari jenis yang ditentukan.

Sintaks

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Parameter

[in] InformationType

Jenis informasi yang diminta driver UMDF tentang perangkat.

[in, out] BufferLength

Penunjuk ke variabel yang, pada input, berisi ukuran, dalam byte, dari buffer yang disediakan RetrieveDeviceInformation di Buffer. Pada output, parameter ini berisi ukuran yang diperlukan RetrieveDeviceInformation untuk Buffer.

[out] Buffer

Penunjuk yang menerima buffer yang berisi informasi perangkat.

Nilai kembali

RetrieveDeviceInformation mengembalikan salah satu nilai berikut:

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

Keterangan

Untuk informasi tentang jenis informasi valid yang dapat diteruskan driver UMDF untuk parameter InformationType , lihat fungsi WinUsb_QueryDeviceInformation .

Jika InformationType DEVICE_SPEED (0x01), saat pengembalian berhasil, Buffer menunjukkan kecepatan pengoperasian perangkat. 0x03 menunjukkan kecepatan tinggi atau lebih tinggi; 0x01 menunjukkan kecepatan penuh atau lebih rendah.

Metode RetrieveDeviceInformation menghasilkan permintaan UMDF dan secara sinkron mengirim permintaan ke target I/O.

Contoh

Untuk contoh kode tentang cara menggunakan metodeRetrieveDeviceInformation , lihat IWDFUsbTargetPipe::SetPipePolicy.

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

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation

Bagikan melalui