HidP_UnsetUsages (hidpi.h)

Artikel
02/29/2024

Set rutin HidP_UnsetUsages yang ditentukan penggunaan tombol kontrol HID NONAKTIF (nol) dalam laporan HID.

Sintaks

NTSTATUS HidP_UnsetUsages(
  [in]           HIDP_REPORT_TYPE     ReportType,
  [in]           USAGE                UsagePage,
  [in, optional] USHORT               LinkCollection,
  [in, out]      PUSAGE               UsageList,
  [in, out]      PULONG               UsageLength,
  [in]           PHIDP_PREPARSED_DATA PreparsedData,
  [in]           PCHAR                Report,
  [in]           ULONG                ReportLength
);

Parameter

[in] ReportType

Menentukan nilai enumerator HIDP_REPORT_TYPE yang menunjukkan jenis laporan yang terletak di Laporan.

[in] UsagePage

Menentukan halaman penggunaan penggunaan yang ditentukan oleh UsageList.

[in, optional] LinkCollection

Menentukan kumpulan tautan yang berisi penggunaan. Jika LinkCollection bukan nol, rutinitas hanya mengatur penggunaan, jika ada, dalam koleksi tautan ini. Jika LinkCollection adalah nol, rutinitas menetapkan penggunaan pertama untuk setiap penggunaan yang ditemukannya di koleksi tingkat atas yang terkait dengan PreparsedData.

[in, out] UsageList

Arahkan ke array penggunaan untuk diatur ke NONAKTIF.

[in, out] UsageLength

Menentukan, pada input, jumlah penggunaan dalam UsageList. Lihat bagian Keterangan untuk informasi tentang nilai output.

[in] PreparsedData

Arahkan ke data yang disiapkan dari koleksi tingkat atas yang terkait dengan laporan yang terletak di Laporan.

[in] Report

Penunjuk ke laporan.

[in] ReportLength

Menentukan ukuran, dalam byte, dari laporan yang terletak di Laporan, yang harus sama dengan panjang laporan untuk jenis laporan tertentu yang HidP_GetCaps kembali dalam struktur HIDP_CAPS koleksi.

Nilai kembali

HidP_UnsetUsages mengembalikan HIDP_STATUS_SUCCESS jika berhasil diatur ke NONAKTIF semua penggunaan dalam UsageList.

HidP_UnsetUsages mengembalikan salah satu nilai status berikut jika salah satu parameter input tidak valid:

Menampilkan kode	Deskripsi
HIDP_STATUS_INVALID_PREPARSED_DATA	Data yang disiapkan yang ditentukan oleh PreparsedData tidak valid.
HIDP_STATUS_INVALID_REPORT_LENGTH	Panjang laporan tidak valid.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipe laporan tidak valid.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Koleksi tidak berisi laporan tipe yang ditentukan.

HidP_UnsetUsages mengembalikan salah satu nilai status berikut jika tidak dapat diatur ke NONAKTIF salah satu penggunaan dalam UsageList:

Menampilkan kode	Deskripsi
HIDP_STATUS_BUTTON_NOT_PRESSED	Penggunaan sudah diatur ke NONAKTIF.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Penggunaan tidak terkandung dalam laporan yang ditentukan, tetapi terkandung dalam laporan lain dari jenis yang ditentukan.
HIDP_STATUS_USAGE_NOT_FOUND	Rutinitas tidak menemukan penggunaan dalam laporan apa pun dari jenis yang ditentukan.

Keterangan

HidP_UnsetUsages menetapkan UsageLength sebagai berikut:

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