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 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 |