HidP_GetExtendedAttributes (hidpi.h)

  • Artikel

Rutinitas HidP_GetExtendedAttributes mengembalikan atribut yang diperluas dari kontrol HID.

Sintaks

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

Parameter

[in] ReportType

Menentukan nilai enumerator HIDP_REPORT_TYPE yang menunjukkan jenis laporan HID yang terkait dengan kontrol HID yang ditentukan oleh DataIndex.

[in] DataIndex

Menentukan indeks data kontrol HID.

[in] PreparsedData

Menentukan data yang telah disiapkan untuk koleksi tingkat atas yang berisi kontrol yang ditentukan.

[out] Attributes

Arahkan ke buffer yang dialokasikan pemanggil yang digunakan rutin untuk mengembalikan atribut kontrol yang diperluas yang ditentukan oleh DataIndex.

[in, out] LengthAttributes

Menentukan ukuran, dalam byte, dari buffer Atribut (yang harus lebih besar dari atau sama dengan sizeof(HIDP_EXTENDED_ATTRIBUTES).

Nilai kembali

HidP_GetExtendedAttributes mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
HIDP_STATUS_SUCCESS
 Rutinitas berhasil mengembalikan semua informasi atribut kontrol yang diperluas.
HIDP_STATUS_BUFFER_TOO_SMALL
 Buffer Atribut tidak cukup besar untuk menyimpan semua informasi atribut yang diperluas.
HIDP_STATUS_DATA_INDEX_NOT_FOUND
 Indeks data yang ditentukan tidak valid.

Keterangan

HidP_GetExtendedAttributes mengembalikan panjang variabel HIDP_EXTENDED_ATTRIBUTES struktur di buffer Atribut . Struktur atribut yang diperluas berisi, dalam urutan berturut-turut, anggota panjang tetap (NumGlobalUnknowns, Reserved, dan GlobalUnknowns) diikuti oleh array panjang variabel struktur HIDP_UNKNOWN_TOKEN . Anggota pertama dari array token yang tidak diketahui terletak di (PHIDP_UNKNOWN_TOKEN*)&(Attributes-Data>).

Rutinitas mengembalikan sebanyak mungkin byte informasi atribut yang diperluas karena buffer Atribut dapat menahannya. Jika buffer terlalu kecil, rutinitas memotong informasi yang dikembalikannya. Untuk menentukan jumlah token yang tidak diketahui dalam array panjang variabel, pemanggil dapat terlebih dahulu menggunakan buffer Atribut untuk mengembalikan nilai anggota NumGlobalUnknowns dari informasi atribut yang diperluas.

Untuk informasi selengkapnya, lihat Koleksi HID.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 2000 dan versi Windows yang lebih baru.
Target Platform Universal
Header hidpi.h (termasuk Hidpi.h)
Pustaka Hidparse.lib
IRQL <= level DISPATCH_

Lihat juga

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA