Função StorPortCaptureLiveDump (storport.h)

Artigo
02/07/2025

StorPortCaptureLiveDump captura um arquivo de despejo ao vivo.

Sintaxe

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

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo de hardware do miniporto.

[in/optional] StorAddress

Ponteiro para uma estrutura de STOR_ADDRESS que contém o endereço que especifica o objeto de unidade. Defina StorAddress como NULL se o dispositivo for um adaptador.

[in] CaptureLivedump

Ponteiro para uma estrutura de STORPORT_CAPTURE_LIVEDUMP que contém os dados necessários para gerar o despejo dinâmico.

Valor de retorno

StorPortCaptureLiveDump retorna um dos seguintes valores:

Código de retorno	Descrição
STOR_STATUS_SUCCESS	A lista de recursos de despejo foi definida com êxito.
STOR_STATUS_INVALID_PARAMETER	Um ou mais dos parâmetros fornecidos são inválidos.
STOR_STATUS_UNSUCCESSFUL	Retornado por outros motivos internos do sistema.

Observações

Quando um miniporto detecta um problema que pode exigir triagem adicional, ele pode chamar StorPortCaptureLiveDump para capturar um arquivo de despejo ao vivo.

Essa função deve ser chamada em PASSIVE_LEVEL.