fungsi WinUsb_QueryDeviceInformation (winusb.h)

Fungsi WinUsb_QueryDeviceInformation mendapatkan informasi tentang perangkat fisik yang terkait dengan handel antarmuka WinUSB.

Sintaks

BOOL WinUsb_QueryDeviceInformation(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      ULONG                   InformationType,
  [in, out] PULONG                  BufferLength,
  [out]     PVOID                   Buffer
);

Parameter

[in] InterfaceHandle

Handel buram ke antarmuka pertama pada perangkat, yang dikembalikan oleh WinUsb_Initialize.

[in] InformationType

Nilai yang menentukan nilai informasi antarmuka mana yang akan diambil.

Pada input, InformationType harus memiliki nilai berikut: DEVICE_SPEED (0x01).

[in, out] BufferLength

Jumlah maksimum byte yang akan dibaca. Angka ini harus kurang dari atau sama dengan ukuran, dalam byte, dari Buffer. Pada output, BufferLength diatur ke jumlah byte aktual yang disalin ke Buffer.

[out] Buffer

Buffer yang dialokasikan penelepon yang menerima nilai yang diminta.

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

Mengembalikan nilai

WinUsb_QueryDeviceInformation mengembalikan TRUE jika operasi berhasil. Jika tidak, rutinitas ini mengembalikan FALSE, dan pemanggil dapat mengambil kesalahan yang dicatat dengan memanggil GetLastError.

GetLastError dapat mengembalikan kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Pemanggil melewati NULL dalam parameter InterfaceHandle .

Persyaratan

Target Platform	Universal
Header	winusb.h (termasuk Winusb.h)
Pustaka	Winusb.lib
DLL	Winusb.dll

Lihat juga

WinUSB

Fungsi WinUSB

WinUsb_Initialize