Функция 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 |