DXGKDDI_PROTECTED_CALLBACK funzione di callback (dispmprt.h)
Il DxgkProtectedCallback routine di callback viene implementato dal driver miniport di visualizzazione e viene chiamato da DxgkCbExcludeAdapterAccess durante uno stato protetto quando viene impedito l'accesso all'adattatore di visualizzazione.
Sintassi
DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;
void DxgkddiProtectedCallback(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] PVOID ProtectedCallbackContext,
[in] NTSTATUS ProtectionStatus
)
{...}
Parametri
[in] MiniportDeviceContext
Handle per 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'adapter è stato protetto correttamente dall'accesso. Un codice di stato dell'errore indica che l'adapter 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 i CONTROLLER di dominio che potrebbero essere stati accodati in qualsiasi CPU ma non ancora gestiti.
- Tutta la memoria combinata in 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 dal DxgkProtectedCallback routine. Il driver non deve modificare lo stato visibile o le funzionalità di qualsiasi applicazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |