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