Funzione StorPortPoFxActivateComponent (storport.h)

Articolo
02/26/2024

La routine StorPortPoFxActivateComponent incrementa il conteggio dei riferimenti di attivazione nel 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 l'adattatore bus host (HBA).

[in, optional] Address

Indirizzo di un'unità dispositivo di archiviazione. Questo parametro è NULL quando si attiva 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 STOR_POFX_DEVICE registrata dal driver miniport 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 usato. Impostare su 0.

Valore restituito

La routine StorPortPoFxActivateComponent restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	Il riferimento di attivazione del dispositivo di archiviazione è stato incrementato correttamente e il componente si trova nello stato attivo.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device è NULL. -oppure- L'indirizzo punta a una struttura di indirizzi di unità non valida. -oppure- Il dispositivo di archiviazione specificato da Address non viene trovato. -oppure- Il dispositivo di archiviazione non è registrato con il framework di risparmio energia (PoFx). -oppure- L'SRB a cui punta Srb non viene inviato da Storport. -oppure- Il parametro Flags è 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 di attivazione del dispositivo di archiviazione è stato incrementato correttamente, ma il componente è ancora nello stato inattivo

Commenti

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

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

Requisiti

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

Vedi anche

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Condividi tramite