IOCTL_HID_GET_PRODUCT_STRING IOCTL (hidclass.h)
IOCTL_HID_GET_PRODUCT_STRING要求會取得 最上層集合的 內嵌字串，以識別製造商的產品。 擷取的字串是以人類可讀的格式，以 NULL 終止的寬字元字串。
如需 HIDClass 裝置的一般資訊 [HID 集合 (/windows-hardware/drivers/hid/hid-collections) 。
主要程序代碼
輸入緩衝區
IRP I/O 堆疊位置中的 Parameters.DeviceIoControl.OutputBufferLength 表示輸出緩衝區的大小，以位元組為單位。 如果輸出緩衝區不夠大，無法保存整個NULL終止的內嵌字串，則要求不會在輸出緩衝區中傳回任何內容。
輸入緩衝區長度
內嵌字串中可能的最大字元數是裝置特定的。 對於USB裝置，字串長度上限為126個字元， (不包含終止的NULL字元) 。
輸出緩衝區
Irp->MdlAddress 指向緩衝區以接收產品標識符字串， (NULL 終止的寬字元字串) 。
輸出緩衝區長度
NULL 終止寬字元字串的長度。 提供的緩衝區必須是 <= 4093 個字節， (2^12 – 3 個) 。
狀態區塊
HID 類別驅動程式會設定下列 Irp-IoStatus> 字段：
信息 會設定為從裝置傳輸的位元元組數目。
如果 傳輸完成且未發生錯誤，狀態會設定為STATUS_SUCCESS。 否則，它會設定為適當的NTSTATUS錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | hidclass.h (包含 Hidclass.h) |
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應