IOCTL_STORAGE_GET_DEVICE_INTERNAL_LOG IOCTL （ntddstor.h）

發行項
02/07/2025

驅動程式可以使用 IOCTL_STORAGE_GET_DEVICE_INTERNAL_LOG 從裝置取得內部狀態數據。

主要程序代碼

輸入緩衝區

識別要查詢之數據類型的 GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST 結構。

輸入緩衝區長度

Parameters.DeviceIoControl.InputBufferLength 會指出 Irp->AssociatedIrp.SystemBuffer的參數緩衝區大小，>= sizeof（GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST）。

輸出緩衝區

驅動程式會將輸出傳回緩衝區 Irp->AssociatedIrp.SystemBuffer。此緩衝區包含具有裝置內部狀態的 DEVICE_INTERNAL_STATUS_DATA 結構。

輸出緩衝區長度

參數.DeviceIoControl.OutputBufferLength 在 I/O 堆棧位置中，會指出參數緩衝區的大小，其必須 >= sizeof（DEVICE_INTERNAL_STATUS_DATA）。

輸入/輸出緩衝區

n/a

輸入/輸出緩衝區長度

n/a

狀態區塊

如果要求成功，Irp->IoStatus.Status 會設定為STATUS_SUCCESS。否則，Status 會設定為適當的錯誤條件作為NTSTATUS程式代碼。如需詳細資訊，請參閱 NTSTATUS 值。

言論

IOCTL_STORAGE_GET_DEVICE_INTERNAL_LOG會從任何記憶體裝置傳回主機起始的裝置遙測記錄。下列虛擬程式代碼示範如何要求遙測數據標頭：

// Allocate a GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST structure, then
// initialize it with a data header request:
//   request.Version = sizeof(GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST);
//   request.Size = sizeof(GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST);
//   request.RequestDataType = DeviceCurrentInternalStatusDataHeader;

// Allocate a DEVICE_INTERNAL_STATUS_DATA structure in which
// to return the header data, with outputBufferLength set to
// (sizeof(DEVICE_INTERNAL_STATUS_DATA) + 512).

// Get the device internal status data.
BOOL result = TRUE;
ULONG returnedLength = 0;
result = DeviceIoControl(deviceHandle,
            IOCTL_STORAGE_GET_DEVICE_INTERNAL_LOG,
            &request,
            sizeof(GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST),
            &outputBuffer,
            outputBufferLength,
            &returnedLength,
            NULL);

要求

要求	價值
最低支援的用戶端	Windows 10 版本 2004
標頭	ntddstor.h

另請參閱

DEVICE_INTERNAL_STATUS_DATA

GET_DEVICE_INTERNAL_STATUS_DATA_REQUEST

共用方式為