IOCTL_ACPI_GET_DEVICE_INFORMATION IOCTL (acpiioct.h)
裝置的驅動程式可以使用IOCTL_ACPI_GET_DEVICE_INFORMATION裝置控制要求來取得其裝置的精細識別資訊。 此 IOCTL 通常是由支援多個裝置版本或修訂的驅動程式使用，而且需要檢查構成裝置 HW 識別符字串的元件元件，以識別確切的裝置。 驅動程式應該呼叫 IoBuildDeviceIoControlRequest ，並傳遞下列輸入和輸出參數來建置此要求。
主要程序代碼
輸入緩衝區
設定 IoBuildDeviceIoControlRequest 輸入參數，如下所示：
- IoControlCode 設定為 IOCTL_ACPI_GET_DEVICE_INFORMATION。
- DeviceObject 設定為實體裝置物件的指標， (裝置的 PDO) 。
- InputBuffer 會設定為輸入緩衝區結構的指標，此結構取決於要傳遞至控件方法的輸入自變數類型。 如需此 IOCTL 支援之輸入自變數類型的詳細資訊，請參閱本主題稍後的一節。
- InputBufferLength 會設定為 InputBuffer 所提供的輸入緩衝區大小，以位元組為單位。
- OutputBufferLength 提供 OutputBuffer 所提供的輸出緩衝區大小，以位元組為單位。
- InternalDeviceIoControl 設定為 FALSE。
- 事件 設定為 NULL。
輸入緩衝區長度
InputBufferLength 會設定為 InputBuffer 所提供的輸入緩衝區大小，以位元組為單位。
輸出緩衝區
設定 IoBuildDeviceIoControlRequest 輸出參數，如下所示：
- OutputBuffer 提供 ACPI_DEVICE_INFORMATION_OUTPUT_BUFFER結構的指標 ，其中包含控件方法的輸出自變數。
- IoStatusBlock 設定為 IO_STATUS_BLOCK 結構。
輸出緩衝區長度
OutputBufferLength 提供 OutputBuffer 所提供的輸出緩衝區大小，以位元組為單位。
狀態區塊
如果要求成功，IoStatusBlock-Status> 會設定為 STATUS_SUCCESS;否則，Status 成員會設定為錯誤碼。 如果輸出緩衝區不夠大，無法包含輸出緩衝區標頭， 則 Status 成員會設定為 STATUS_BUFFER_TOO_SMALL。 如果輸出緩衝區夠大，足以包含輸出緩衝區標頭，但不足以包含控件方法的所有輸出自變數，Status 成員會設定為 STATUS_BUFFER_OVERFLOW，而 OutputBuffer-Length> 會設定為輸出緩衝區的必要長度。
如果要求成功，IoStatusBlock-Information> 成員會設定為輸出緩衝區中傳回的位元組數目，否則資訊成員會設定為零。
備註
裝置的驅動程式可以使用IOCTL_ACPI_GET_DEVICE_INFORMATION來取得其裝置的精細識別資訊。 此 IOCTL 通常與支援多個硬體版本或裝置修訂的驅動程式搭配使用，而且必須檢查構成裝置 HW 識別符字串的元件元件，以識別確切的裝置。 例如，驅動程式可能支援相同裝置的不同修訂，其中程式設計介面的某些層面或裝置的行為不同。 驅動程式可以確切識別執行所在的修訂。
來自要求的輸出自變數會在 OutBuffer 指標所提供的可變長度ACPI_DEVICE_INFORMATION_OUTPUT_BUFFER結構中傳回。 ACPI_DEVICE_INFORMATION_OUTPUT_BUFFER包含可變長度數位的陣列，每個數位都會分別傳回代表子系統標識符字串、廠商標識元字串和實例標識符字串的輸出自變數。
IOCTL_ACPI_GET_DEVICE_INFORMATION只能在 IRQL <= DISPATCH_LEVEL使用。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 和更新版本的 Windows。 |
| 標頭 | acpiioct.h (include Acpiioct.h) |