Fonction D3DKMTSharedPrimaryLockNotification (d3dkmthk.h)
La fonction D3DKMTSharedPrimaryLockNotification informe le système d’exploitation d’un verrouillage à venir sur une surface primaire partagée.
Syntaxe
NTSTATUS D3DKMTSharedPrimaryLockNotification(
[in] const D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION *unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure de D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION qui décrit la surface principale partagée qu’une application verrouillera.
Valeur retournée
D3DKMTSharedPrimaryLockNotification retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | La notification d’un verrouillage à venir sur une surface primaire partagée a été effectuée avec succès. |
| STATUS_NO_MEMORY | D3DKMTSharedPrimaryLockNotification n’a pas pu se terminer en raison d’une mémoire insuffisante. |
| STATUS_INVALID_PARAMETER | Les paramètres ont été validés et déterminés comme incorrects. |
Cette fonction peut également retourner d’autres valeurs NTSTATUS définies dans Ntstatus.h.
Remarques
L’ICD OpenGL appelle la fonction D3DKMTSharedPrimaryLockNotification pour informer le système d’exploitation qu’une application est sur le point de verrouiller la surface principale partagée GDI qui existe sur la carte graphique et la source vidéo présente que les membres AdapterLuid et VidPnSourceId de la structure D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION spécifient. L’ICD OpenGL doit appeler D3DKMTSharedPrimaryLockNotification avant d’appeler la fonction D3DKMTLock pour la surface principale partagée GDI afin de s’assurer que le système d’exploitation désactive tous les sprites qui se croisent avec la région de verrouillage spécifiée par le membre LockRect de D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Plateforme cible | Universal |
| En-tête | d3dkmthk.h (inclure D3dkmthk.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |