Поделиться через


Функция StorPortCaptureLiveDump (storport.h)

StorPortCaptureLiveDump захватывает динамический файл дампа.

Синтаксис

ULONG StorPortCaptureLiveDump(
  [in]          PVOID                      HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS              StorAddress,
  [in]          PSTORPORT_CAPTURE_LIVEDUMP CaptureLivedump
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства мини-порта.

[in/optional] StorAddress

Указатель на структуру STOR_ADDRESS , содержащую адрес, указывающий объект единицы измерения. Задайте для StorAddress значение NULL, если устройство является адаптером.

[in] CaptureLivedump

Указатель на структуру STORPORT_CAPTURE_LIVEDUMP , содержащую данные, необходимые для создания динамического дампа.

Возвращаемое значение

StorPortCaptureLiveDump возвращает одно из следующих значений:

Код возврата Описание
STOR_STATUS_SUCCESS Список функций дампа успешно задан.
STOR_STATUS_INVALID_PARAMETER Один или несколько указанных параметров являются недопустимыми.
STOR_STATUS_UNSUCCESSFUL Возвращается по другим внутренним системным причинам.

Комментарии

Когда мини-порт обнаруживает проблему, которая может потребовать дальнейшего рассмотрения, он может вызвать StorPortCaptureLiveDump для записи динамического файла дампа.

Эта функция должна вызываться в PASSIVE_LEVEL.

Требования

Требование Значение
Минимальная версия сервера Windows Server 2022
Верхняя часть storport.h
IRQL PASSIVE_LEVEL

См. также раздел

STOR_ADDRESS

STORPORT_CAPTURE_LIVEDUMP

STORPORT_LIVEDUMP_DATA_TYPE

STORPORT_LIVEDUMP_DEVICE_TELEMETRY_LOG