Funzione PcRequestNewPowerState (portcls.h)

Articolo
08/07/2023

La funzione PcRequestNewPowerState viene usata per richiedere un nuovo stato di alimentazione per il dispositivo. Questa funzione non è in genere necessaria dai driver dell'adattatore, ma può essere utile occasionalmente per risolvere alcuni tipi di problemi hardware.

Sintassi

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

Parametri

[in] pDeviceObject

Puntatore all'oggetto dispositivo funzionale dell'adattatore (FDO). Questo parametro deve puntare a una struttura di sistema di tipo DEVICE_OBJECT.

[in] RequestedNewState

Specifica lo stato di alimentazione del dispositivo richiesto. Impostare questo parametro su uno dei valori di enumerazione DEVICE_POWER_STATE seguenti: PowerDeviceD0, PowerDeviceD1,PowerDeviceD2 o PowerDeviceD3.

Valore restituito

PcRequestNewPowerState restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un messaggio di errore appropriato.

Commenti

Un driver di adattatore può chiamare PcRequestNewPowerState per compensare i difetti di progettazione hardware. Ad esempio, se le funzioni in una scheda audio non sono reciprocamente indipendenti e devono essere arrestate in un determinato ordine, l'adattatore può chiamare PcRequestNewPowerState per assicurarsi che un determinato sottodevice venga arrestato per primo.

Il parametro RequestedNewState può essere impostato su uno dei valori di enumerazione DEVICE_POWER_STATE nella tabella seguente.

Stato di alimentazione	Significato
PowerDeviceD0	Stato di alimentazione completa
PowerDeviceD1	Stato di sospensione con la latenza di alimentazione più bassa
PowerDeviceD2	Stato di sospensione a latenza media
PowerDeviceD3	Stato di ibernazione completo e stato di sospensione con la latenza di alimentazione più lunga

L'hardware può essere accessibile solo in power state PowerDeviceD0. In qualsiasi altro stato, il driver deve memorizzare nella cache gli accessi hardware tentati e rinviare tali accessi fino al ripristino dello stato di PowerDeviceD0 .

Per altre informazioni, vedere Risparmio energia per dispositivi audio.

Requisiti

Requisito	Valore
Client minimo supportato	Il driver di sistema PortCls implementa la funzione PcRequestNewPowerState in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	portcls.h (includere Portcls.h)
Libreria	Portcls.lib
IRQL	PASSIVE_LEVEL

Vedi anche

DEVICE_OBJECT

Condividi tramite