HidP_UnsetUsages (hidpi.h)
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 |
---|---|
|
Data yang disiapkan yang ditentukan oleh PreparsedData tidak valid. |
|
Panjang laporan tidak valid. |
|
Tipe laporan tidak valid. |
|
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 |
---|---|
|
Penggunaan sudah diatur ke NONAKTIF. |
|
Penggunaan tidak terkandung dalam laporan yang ditentukan, tetapi terkandung dalam laporan lain dari jenis yang ditentukan. |
|
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 |