DXGKCB_SYNCHRONIZE_EXECUTION fonction de rappel (dispmprt.h)
La fonction DxgkCbSynchronizeExecution synchronise une fonction spécifiée, implémentée par le pilote miniport d’affichage, avec la fonction DxgkDdiInterruptRoutine du pilote d’affichage.
Syntaxe
DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;
NTSTATUS DxgkcbSynchronizeExecution(
[in] HANDLE DeviceHandle,
[in] PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
[in] PVOID Context,
[in] ULONG MessageNumber,
[out] PBOOLEAN ReturnValue
)
{...}
Paramètres
[in] DeviceHandle
Handle qui représente un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment obtenu ce handle dans le membre DeviceHandle de la structure DXGKRNL_INTERFACE qui a été passée à DxgkDdiStartDevice.
[in] SynchronizeRoutine
Pointeur vers une fonction, implémenté par le pilote miniport d’affichage, qui sera synchronisé avec DxgkDdiInterruptRoutine. La fonction doit être conforme au prototype suivant :
BOOLEAN SynchronizeRoutine(PVOID Context);
[in] Context
Pointeur vers un bloc de contexte, créé par le pilote de miniport d’affichage, qui sera transmis à SynchronizeRoutine.
[in] MessageNumber
Nombre de messages d’interruption avec lesquels synchroniser le synchroniser. Si l’interruption est basée sur une ligne, ce paramètre doit être égal à zéro.
[out] ReturnValue
Pointeur vers une variable booléenne qui reçoit la valeur de retour de SynchronizeRoutine.
Valeur de retour
DxgkCbSynchronizeExecution retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La fonction a réussi. |
| STATUS_INVALID_PARAMETER | L’un des paramètres n’est pas valide. |
| STATUS_UNSUCCESSFUL | La fonction n’a pas pu synchroniser l’exécution, peut-être parce que l’interruption n’avait pas encore été connectée. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | <=DISPATCH_LEVEL |