Funzione StorPortCaptureLiveDump (storport.h)

Articolo
02/26/2024

StorPortCaptureLiveDump acquisisce un file di dump live.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware del miniport.

[in/optional] StorAddress

Puntatore a una struttura STOR_ADDRESS che contiene l'indirizzo che specifica l'oggetto unit. Impostare StorAddress su NULL se il dispositivo è un adattatore.

[in] CaptureLivedump

Puntatore a una struttura STORPORT_CAPTURE_LIVEDUMP contenente i dati necessari per generare il dump live.

Valore restituito

StorPortCaptureLiveDump restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	L'elenco delle funzionalità di dump è stato impostato correttamente.
STOR_STATUS_INVALID_PARAMETER	Uno o più dei parametri forniti non sono validi.
STOR_STATUS_UNSUCCESSFUL	Restituito per altri motivi di sistema interni.

Commenti

Quando un miniport rileva un problema che potrebbe richiedere ulteriori triage, può chiamare StorPortCaptureLiveDump per acquisire un file di dump live.

Questa funzione deve essere chiamata in PASSIVE_LEVEL.