DXGKDDI_CONTROLINTERRUPT fonction de rappel (d3dkmddi.h)

  • Article

La fonction DxgkDdiControlInterrupt active ou désactive le type d’interruption donné sur le matériel graphique.

Syntaxe

DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;

NTSTATUS DxgkddiControlinterrupt(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
  [in] IN_BOOLEAN EnableInterrupt
)
{...}

Paramètres

[in] hAdapter

Handle de l’objet adaptateur pour l’unité de traitement graphique (GPU). Le pilote a retourné ce handle dans le paramètre MiniportDeviceContext à partir d’un appel à sa fonction DxgkDdiAddDevice .

[in] InterruptType

Valeur de type DXGK_INTERRUPT_TYPE qui fournit le type d’interruption.

[in] EnableInterrupt

Valeur booléenne qui indique si DxgkDdiControlInterrupt active ou désactive le type d’interruption spécifié. TRUE indique qu’il active et FALSE indique qu’il désactive.

Valeur retournée

DxgkDdiControlInterrupt retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS Le type d’interruption a été correctement activé ou désactivé sur le matériel graphique.
STATUS_NOT_IMPLEMENTED DxgkDdiControlInterrupt ne prend pas en charge l’activation ou la désactivation du type d’interruption spécifié.

Remarques

La fonction DxgkDdiControlInterrupt du pilote miniport d’affichage peut activer ou désactiver le type d’interruption spécifié. Toutefois, DxgkDdiControlInterrupt n’est pas nécessaire pour désactiver le type d’interruption si le pilote nécessite le type d’interruption à des fins internes. Un appel à DxgkDdiControlInterrupt pour activer le type d’interruption spécifié indique que le système d’exploitation nécessite que le pilote appelle la fonction DxgkCbNotifyInterrupt pour signaler quand le type d’interruption est déclenché sur le matériel graphique.

Actuellement, le sous-système du noyau graphique Microsoft DirectX spécifie uniquement le type d’interruption DXGK_INTERRUPT_CRTC_VSYNC dans le paramètre InterruptType . Un appel à DxgkDdiControlInterrupt pour activer la DXGK_INTERRUPT_CRTC_VSYNC type d’interruption indique que le pilote contrôle l’interruption de retracement verticale. Pendant chaque période de retracement vertical et immédiatement après que l’adresse de surface primaire spécifiée dans le registre DAC a été bloquée et analysée, l’interruption doit être déclenchée et signalée.

Le pilote doit retourner STATUS_NOT_IMPLEMENTED si un type d’interruption autre que DXGK_INTERRUPT_CRTC_VSYNC est fourni.

DxgkDdiControlInterrupt doit être rendu paginable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt

DxgkDdiAddDevice