HidP_GetLinkCollectionNodes (hidpi.h)

Rutinitas HidP_GetLinkCollectionNodes mengembalikan array koleksi tautantingkat atas.

Sintaks

NTSTATUS HidP_GetLinkCollectionNodes(
  [out]     PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
  [in, out] PULONG                     LinkCollectionNodesLength,
  [in]      PHIDP_PREPARSED_DATA       PreparsedData
);

Parameter

[out] LinkCollectionNodes

Penunjuk ke array struktur HIDP_LINK_COLLECTION_NODE yang dialokasikan pemanggil di mana HidP_GetLinkCollectionNodes mengembalikan array kumpulan tautan koleksi tingkat atas.

[in, out] LinkCollectionNodesLength

Menentukan, pada input, panjang, dalam elemen array, dari buffer LinkCollectionNodes . Pada output, rutin mengatur LinkCollectionNodesLength ke jumlah entri dalam array yang ditetapkannya.

[in] PreparsedData

Penunjuk ke data yang telah disiapkan dari koleksi tingkat atas tempat rutinitas ini mengembalikan array pengumpulan tautan.

Nilai kembali

HidP_GetLinkCollectionNodes mengembalikan salah satu kode status berikut:

Menampilkan kode Deskripsi
HIDP_STATUS_SUCCESS
Rutinitas berhasil mengembalikan array koleksi tautan yang ditentukan.
HIDP_STATUS_INVALID_PREPARSED_DATA
Data yang disiapkan tidak valid.
HIDP_STATUS_BUFFER_TOO_SMALL
Buffer LinkCollectionNodes terlalu kecil untuk menahan seluruh array koleksi tautan.

Keterangan

Panjang buffer LinkCollectionNodes yang diperlukan ditentukan oleh anggota NumberLinkCollectionNodes dari struktur HIDP_CAPS koleksi.

Jika HidP_GetLinkCollectionNodes mengembalikan nilai status HIDP_STATUS_BUFFER_TOO_SMALL, itu juga mengatur LinkCollectionNodesLength ke panjang, dalam elemen array, diperlukan untuk menyimpan informasi node pengumpulan tautan.

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 <= DISPATCH_LEVEL

Lihat juga

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA