DXGKDDI_PROTECTED_CALLBACK funzione di callback (dispmprt.h)

  • Articolo

La routine di callback DxgkProtectedCallback viene implementata dal driver miniport di visualizzazione e viene chiamata da DxgkCbExcludeAdapterAccess durante uno stato protetto quando viene impedito tutto l'accesso alla scheda di visualizzazione.

Sintassi

DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;

void DxgkddiProtectedCallback(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] PVOID ProtectedCallbackContext,
  [in] NTSTATUS ProtectionStatus
)
{...}

Parametri

[in] MiniportDeviceContext

Handle di un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel grafico DirectX.

[in] ProtectedCallbackContext

Puntatore alle informazioni definite dal driver specificate in una chiamata precedente a DxgkCbExcludeAdapterAccess.

[in] ProtectionStatus

Stato dello stato protetto dell'adattatore di visualizzazione. Se STATUS_SUCCESS, l'adattatore è stato protetto correttamente dall'accesso. Un codice di stato di errore indica che l'adattatore non è protetto.

Valore restituito

nessuno

Osservazioni

DxgkProtectedCallback deve essere chiamato solo quando tutto l'accesso alla scheda di visualizzazione è stato interrotto, come indicato dal parametro di stato ProtectionStatus.

Il driver deve assicurarsi che durante la routine di callback vengano soddisfatte le condizioni seguenti:

  • Tutti gli interrupt nel dispositivo sono disabilitati e tutti gli interrupt in sospeso rimanenti vengono gestiti, inclusi tutti i CONTROLLER di dominio che potrebbero essere stati accodati in qualsiasi CPU ma non ancora gestiti.
  • Tutta la memoria combinata di scrittura e tutti gli altri stati correlati alla cache sono stati scaricati.
  • Tutti gli eventi ACPI o BIOS/SMI che si verificano non accedono all'hardware.
  • La coerency viene ottenuta tra tutte le schede in una configurazione dello stato dell'adattatore collegato.
  • L'adattatore, inclusi i registri e la modalità di visualizzazione, viene mantenuto nello stato corretto per gestire il buffer DMA che si verifica sulla restituzione dalla routine DxgkProtectedCallback . Il driver non deve modificare lo stato visibile o le funzionalità di qualsiasi applicazione.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Vedi anche

DxgkCbExcludeAdapterAccess