Função StorPortCaptureLiveDump (storport.h)

Artigo
02/29/2024

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 de dispositivo de hardware do miniport.

[in/optional] StorAddress

Ponteiro para uma estrutura 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 STORPORT_CAPTURE_LIVEDUMP que contém os dados necessários para gerar o despejo dinâmico.

Retornar valor

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.

Comentários

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

Essa função deve ser chamada em PASSIVE_LEVEL.