Función StorPortCaptureLiveDump (storport.h)

Artículo
02/26/2024

StorPortCaptureLiveDump captura un archivo de volcado en vivo.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware del miniporte.

[in/optional] StorAddress

Puntero a una estructura de STOR_ADDRESS que contiene la dirección que especifica el objeto de unidad. Establezca StorAddress en NULL si el dispositivo es un adaptador.

[in] CaptureLivedump

Puntero a una estructura de STORPORT_CAPTURE_LIVEDUMP que contiene los datos necesarios para generar el volcado en directo.

Valor devuelto

StorPortCaptureLiveDump devuelve uno de los siguientes valores:

Código devuelto	Descripción
STOR_STATUS_SUCCESS	La lista de características de volcado de memoria se estableció correctamente.
STOR_STATUS_INVALID_PARAMETER	Uno o varios de los parámetros proporcionados no son válidos.
STOR_STATUS_UNSUCCESSFUL	Se devuelve por otros motivos internos del sistema.

Comentarios

Cuando un minipuerto detecta un problema que podría requerir una evaluación de prioridades adicional, puede llamar a StorPortCaptureLiveDump para capturar un archivo de volcado en directo.

Se debe llamar a esta función en PASSIVE_LEVEL.