DXGKDDI_CONTROLINTERRUPT fonction de rappel (d3dkmddi.h)
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 vers l’objet adaptateur pour l’unité de traitement graphique (GPU). Le pilote a retourné ce handle dans le paramètre MiniportDeviceContext d’un appel à sa fonction DxgkDdiAddDevice.
[in] InterruptType
Valeur DXGK_INTERRUPT_TYPE-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 de retour
DxgkDdiControlInterrupt retourne l’une des valeurs suivantes :
Retourner le code | Description |
---|---|
STATUS_SUCCESS | Le type d’interruption a été activé ou désactivé avec succès 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 requiert 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 exige 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 le type d’interruption DXGK_INTERRUPT_CRTC_VSYNC indique que le pilote contrôle l’interruption de trace verticale. Pendant chaque période de retrace verticale et immédiatement après que l’adresse de surface principale spécifiée dans le registre DAC soit 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.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows Vista |
plateforme cible | Bureau |
d’en-tête | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |