DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 fonction de rappel (d3dkmddi.h)
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 est appelée pour modifier la configuration de superposition affichée.
Syntaxe
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;
NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
IN_CONST_HANDLE hAdapter,
IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}
Paramètres
hAdapter
Identifie l’adaptateur contenant le matériel de superposition.
pSetVidPnSourceAddressWithMultiPlaneOverlay
Pointeur vers une structure DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 qui décrit les surfaces et les options d’affichage à présenter.
Valeur de retour
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 retourne les valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La routine s’est terminée avec succès. |
| STATUS_INVALID_PARAMETER | Dans le [modèle de file d’attente de retournement matériel]/windows-hardware/drivers/display/hardware-flip-queue), le pilote n’a pas pu traiter une demande de retournement. |
| STATUS_RETRY | Retourné pour des raisons telles que le pilote n’a pas pu file d’attente une demande adressée au matériel en raison de retournements en attente ou le pilote doit être appelé au niveau de l’PASSIVE_LEVEL. Si le pilote doit être appelé à PASSIVE_LEVEL il doit également définir la DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS.indicateur PrePresentNeededed. |
Remarques
Cette fonction est généralement appelée au niveau des interruptions, mais si le pilote doit effectuer une configuration matérielle qui ne peut être effectuée qu’à PASSIVE_LEVEL, le pilote peut demander que cette fonction soit rappelée à PASSIVE_LEVEL en retournant STATUS_RETRY et en définissant la DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS.indicateur PrePresentNeededed.
Même lorsqu’il est appelé à PASSIVE_LEVEL, le pilote doit éviter de passer un certain temps dans cet appel, car l’appel bloque le thread du planificateur GPU principal et le retard peut entraîner des problèmes. Les actions nécessitant beaucoup de temps doivent être mises en file d’attente en tant qu’éléments de travail distincts par pilote et gérées en arrière-plan. Dans ce scénario, tous les conflits entre l’élément mis en file d’attente et les modifications matérielles demandées par les futurs appels avant/post doivent être gérés par le pilote.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | d3dkmddi.h |