PUSB_BUSIFFN_QUERY_BUS_INFORMATION fungsi panggilan balik (usbbusif.h)

  • Artikel

Rutinitas QueryBusInformation mendapatkan informasi tentang bus.

Sintaks

typedef NTSTATUS
  (USB_BUSIFFN *PUSB_BUSIFFN_QUERY_BUS_INFORMATION) (
    IN PVOID,
    IN ULONG,
    IN OUT PVOID,
    IN OUT PULONG,
    OUT PULONG
  );

Parameter

[in] unnamedParam1

Menangani yang dikembalikan di anggota BusContext dari struktur USB_BUS_INTERFACE_USBDI_V0 dengan permintaan IRP_MN_QUERY_INTERFACE.

[out, optional] unnamedParam2

Menentukan panjang data output.

[in, out] unnamedParam3

Arahkan ke buffer yang menerima informasi bus yang diminta.

[out] unnamedParam4

Pada input, panjang buffer yang ditentukan oleh BusInformationBuffer. Pada output, panjang data output.

[in] unnamedParam5

Menentukan tingkat informasi yang akan dikembalikan. Jika Level adalah 0, fungsi mengembalikan total bandwidth dan total bandwidth yang digunakan dalam bit per detik. Jika Level adalah 1, fungsi mengembalikan nama simbolis pengontrol di Unicode, selain total bandwidth dan total bandwidth yang digunakan.

Nilai kembali

QueryBusInformation mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Panggilan berhasil diselesaikan.
STATUS_BUFFER_TOO_SMALL Buffer terlalu kecil. Kode kesalahan ini dikembalikan dalam dua kasus:

Whenever Level == 0, kode kesalahan ini dikembalikan jika ukuran buffer yang diacu oleh BusInformationBuffer kurang dari ukuran struktur USB_BUS_INFORMATION_LEVEL_0 .

Setiap kali Level == 1, kode kesalahan ini dikembalikan jika ukuran buffer yang diacu oleh BusInformationBuffer kurang dari ukuran struktur USB_BUS_INFORMATION_LEVEL_1 .

Keterangan

Informasi persis yang dikembalikan oleh rutinitas ini tergantung pada nilai parameter Level . Rutinitas ini menggantikan fungsi pustaka USBD_QueryBusInformation yang disediakan oleh usbd.sys.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header usbbusif.h (termasuk Usbbusif.h)
IRQL < = DISPATCH_LEVEL

Lihat juga