DXGKDDI_PROTECTED_CALLBACK fonction de rappel (dispmprt.h)
La routine de rappel DxgkProtectedCallback est implémentée par le pilote display miniport et est appelée par DxgkCbExcludeAdapterAccess pendant un état protégé lorsque tout l’accès à l’adaptateur d’affichage est empêché.
Syntaxe
DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;
void DxgkddiProtectedCallback(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] PVOID ProtectedCallbackContext,
[in] NTSTATUS ProtectionStatus
)
{...}
Paramètres
[in] MiniportDeviceContext
Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle au sous-système du noyau graphique DirectX.
[in] ProtectedCallbackContext
Pointeur vers les informations définies par le pilote spécifiées dans un appel précédent à DxgkCbExcludeAdapterAccess.
[in] ProtectionStatus
État de l’état protégé de l’adaptateur d’affichage. Si STATUS_SUCCESS, l’adaptateur a été correctement protégé contre l’accès. Un code d’état d’échec indique que l’adaptateur n’est pas protégé.
Valeur de retour
Aucun
Remarques
DxgkProtectedCallback doit être appelée uniquement lorsque tous les accès à l’adaptateur d’affichage ont été arrêtés, comme indiqué par le paramètre d’état ProtectionStatus.
Le pilote doit s’assurer que les conditions suivantes sont remplies pendant la routine de rappel :
- Toutes les interruptions sur l’appareil sont désactivées et toutes les interruptions restantes en attente sont gérées, y compris les contrôleurs de domaine qui ont peut-être été mis en file d’attente sur n’importe quel processeur, mais pas encore pris en charge.
- Toutes les mémoires combinées en écriture et tous les autres états liés au cache ont été vidés.
- Tous les événements ACPI ou BIOS/SMI qui se produisent n’accèdent pas au matériel.
- La cohérence est obtenue entre tous les adaptateurs dans une configuration d’état de l’adaptateur lié.
- L’adaptateur, y compris ses registres et son mode d’affichage, est conservé dans l’état approprié pour gérer la mémoire tampon DMA qui se produit sur le retour de la routine DxgkProtectedCallback. Le pilote ne doit pas modifier l’état visible ou les fonctionnalités d’une application.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |