fungsi WinUsb_QueryDeviceInformation (winusb.h)

Artikel
08/27/2023

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.