Funzione StorPortPoFxIdleComponent (storport.h)

Articolo
02/07/2025

Il StorPortPoFxIdleComponent routine decrementa il conteggio dei riferimenti di attivazione di un componente specificato di un dispositivo di archiviazione.

Sintassi

ULONG StorPortPoFxIdleComponent(
  [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'inattività di un componente dell'adattatore di archiviazione.

[in, optional] Srb

SRB che attiva la disattivazione del componente. Questo parametro è NULL se il miniport sta inattiva internamente un componente del dispositivo.

[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 StorPortPoFxIdleComponent restituisce uno di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	Il riferimento all'attivazione del dispositivo di archiviazione è stato decrementato correttamente e il componente è inattivo.
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. -o- StorPortPoFxIdleComponent è stato chiamato con un componente inattivo e un Srb per cui non è stata eseguita una chiamata precedente a StorPortPoFxActivateComponent.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL corrente.
STOR_STATUS_BUSY	Il riferimento attivo per il componente del dispositivo è stato decrementato, ma il componente è ancora attivo.

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 StorPortPoFxIdleComponent deve essere associata a una chiamata precedente a StorPortPoFxActivateComponent.