DXGKCB_SYNCHRONIZE_EXECUTION fonction de rappel (dispmprt.h)

Article
05/23/2024

La fonction DxgkCbSynchronizeExecution synchronise une fonction spécifiée, implémentée par le pilote de miniport d’affichage, avec la fonction DxgkDdiInterruptRoutine du pilote de miniport 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 de 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ée par le pilote de miniport d’affichage, qui sera synchronisée 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 passé à SynchronizeRoutine.

[in] MessageNumber

Numéro du message d’interruption avec lequel SynchronizeRoutine sera synchronisé. 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 retournée

DxgkCbSynchronizeExecution retourne l’une des valeurs suivantes :

Code de retour	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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dispmprt.h (include Dispmprt.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

DxgkDdiInterruptRoutine

KeSynchronizeExecution

Partager via