Funzione StorPortPoFxIdleComponent (storport.h)

Articolo
02/26/2024

La routine StorPortPoFxIdleComponent 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 l'adattatore 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 è inattiva internamente un componente del dispositivo.

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

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	Il riferimento di attivazione del dispositivo di archiviazione è stato decrementato correttamente e il componente è inattivo.
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. -oppure- StorPortPoFxIdleComponent è stato chiamato con un componente inattivo e un Srb per il quale 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.

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