PDXGK_POWER_NOTIFICATION funzione di callback (d3dkmthk.h)

Articolo
02/25/2024

Callback che fornisce una notifica che indica che il dispositivo grafico sarà in fase di transizione dello stato di alimentazione del dispositivo.

Sintassi

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

void PdxgkPowerNotification(
  PVOID GraphicsDeviceHandle,
  DEVICE_POWER_STATE NewGrfxPowerState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Parametri

GraphicsDeviceHandle

Handle opaco che deve essere fornito quando si effettuano callback al dispositivo grafico.

NewGrfxPowerState

Valore DEVICE_POWER_STATE che indica il nuovo stato di alimentazione grafica in corso di impostazione.

PreNotification

Valore booleano che indica se deve essere fornita una notifica.

PrivateHandle

Handle opaco fornito in qualsiasi callback. Questo handle deve essere univoco a livello globale, pertanto deve essere usato un puntatore al PDO o al fdO del driver chiamante.

Valore restituito

nessuno

Osservazioni

Questo callback viene eseguito al PASSIVE_LEVEL. Il driver può bloccare per completare la manutenzione dell'operazione solo quando il nuovo stato di alimentazione è PowerDeviceD3. In questo caso, la chiamata deve comunque essere completata in modo tempestivo, in quanto può bloccare il completamento della transizione complessiva dello stato di alimentazione del dispositivo ed è soggetta a un controllo di bug del watchdog di alimentazione. Il driver non deve bloccare quando il nuovo stato è PowerDeviceD0. Quando si passa a PowerDeviceD3, verrà fornita una notifica "pre" e "post", presupponendo che la transizione non venga annullata nel frattempo. Quando si passa a PowerDeviceD0, verrà fornita solo una notifica "post". È consentito a questo gestore di callback chiamare il callback di grafica SetSharedPowerComponentStateCb, se necessario; nessun altro callback nel kernel grafico è consentito da questo gestore.

Importante

Lo stato iniziale di alimentazione grafica verrà fornito nell'output IOCTL, tuttavia, poiché è possibile che il dispositivo grafico sia in fase di transizione dello stato di alimentazione durante la registrazione, è necessario acquisire un mutex intorno alla chiamata IOCTL e l'analisi dello stato originale e che lo stesso mutex deve essere acquisito in questa funzione di callback. In questo modo, se si esegue la transizione dello stato, il callback fornirà le informazioni sullo stato più aggiornate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	d3dkmthk.h
IRQL	<= PASSIVE_LEVEL

Vedi anche

DEVICE_POWER_STATE

Condividi tramite