DXGKDDI_PROTECTED_CALLBACK funzione di callback (dispmprt.h)
La routine di callback DxgkProtectedCallback viene implementata dal driver miniport visualizzato 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 a un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel della grafica DirectX.
[in] ProtectedCallbackContext
Puntatore a 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 è stato arrestato tutto l'accesso alla scheda di visualizzazione, come indicato dal parametro di stato ProtectionStatus.
Il driver deve assicurarsi che le condizioni seguenti vengano soddisfatte durante la routine di callback:
- Tutti gli interruzioni nel dispositivo sono disabilitati e tutti gli interruzioni rimanenti in sospeso vengono gestiti, inclusi tutti i DPC che potrebbero essere stati accodati su qualsiasi CPU ma non ancora gestito.
- Tutte le memoria combinate 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 coency viene ottenuta tra tutte le schede in una configurazione dello stato dell'adattatore collegato.
- L'adapter, inclusi i registri e la modalità di visualizzazione, viene mantenuto nello stato appropriato 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 | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | dispmprt.h (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL |