Condividi tramite


Funzione StorPortCaptureLiveDump (storport.h)

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 è una scheda.

[in] CaptureLivedump

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

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ù parametri forniti non sono validi.
STOR_STATUS_UNSUCCESSFUL Restituito per altri motivi di sistema interni.

Osservazioni

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

Questa funzione deve essere chiamata in PASSIVE_LEVEL.

Fabbisogno

Requisito Valore
server minimo supportato Windows Server 2022
intestazione storport.h
IRQL PASSIVE_LEVEL

Vedere anche

STOR_ADDRESS

STORPORT_CAPTURE_LIVEDUMP

STORPORT_LIVEDUMP_DATA_TYPE

STORPORT_LIVEDUMP_DEVICE_TELEMETRY_LOG