Funzione StorPortPoFxActivateComponent (storport.h)

Articolo
02/07/2025

La routine StorPortPoFxActivateComponent incrementa il conteggio dei riferimenti di attivazione sul componente specificato di un dispositivo di archiviazione.

Sintassi

ULONG StorPortPoFxActivateComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per la scheda bus host (HBA).

[in, optional] Address

Indirizzo di un'unità dispositivo di archiviazione. Questo parametro è NULL durante l'attivazione di un componente dell'adattatore di archiviazione.

[in, optional] Srb

SRB che attiva l'attivazione del componente. Questo parametro è NULL se il miniport attiva un componente del dispositivo per una richiesta non inviata tramite Storport.

[in] Component

Indice che identifica il componente. Questo parametro è un indice nella matrice Components nella struttura di STOR_POFX_DEVICE che il driver miniport registrato per il dispositivo con una chiamata a StorPortInitializePoFxPower. Se la matrice Components contiene N elementi, gli indici dei componenti sono compresi tra 0 e N-1.

[in] Flags

Non utilizzato. Impostare su 0.

Valore restituito

La routine StorPortPoFxActivateComponent restituisce uno di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	Il riferimento all'attivazione del dispositivo di archiviazione è stato incrementato correttamente e il componente si trova nello stato attivo.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device è NULL. -o- Address punta a una struttura di indirizzi di unità non valida. -o- Il dispositivo di archiviazione specificato da Address non viene trovato. -o- Il dispositivo di archiviazione non è registrato con il framework di risparmio energia (PoFx). -o- SRB a cui punta Srb non viene inviato da Storport. -o- Il parametro flag è diverso da zero.
STOR_STATUS_INVALID_DEVICE_REQUEST	L'adattatore o l'unità non supporta PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL corrente.
STOR_STATUS_BUSY	Il riferimento all'attivazione del dispositivo di archiviazione è stato incrementato correttamente, ma il componente è ancora nello stato di inattività

Osservazioni

Attualmente, sia i dispositivi adattatori che i dispositivi unità hanno un numero massimo di componenti pari a 1. L'indice in Componente deve essere sempre impostato su 0.

Ogni chiamata a StorPortPoFxActivateComponent deve essere associata a una chiamata successiva a StorPortPoFxIdleComponent.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	storport.h
libreria	Storport.lib
IRQL	IRQL <= DISPATCH_LEVEL

Vedere anche

STOR_POFX_DEVICE

StorPortInitializePoFxPower

storPortPoFxIdleComponent

Condividi tramite