PFND3D10DDI_SO_SETTARGETS fonction de rappel (d3d10umddi.h)

  • Article

La fonction SoSetTargets définit les ressources cibles de sortie de flux.

Syntaxe

PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;

void Pfnd3d10ddiSoSettargets(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumBuffers,
  [in] UINT ClearTargets,
       const D3D10DDI_HRESOURCE *unnamedParam4,
       const UINT *unnamedParam5
)
{...}

Paramètres

unnamedParam1

hDevice [in]

Handle pour le périphérique d’affichage (contexte graphique).

[in] NumBuffers

Nombre d’éléments spécifiés dans le tableau par phResource .

[in] ClearTargets

Nombre de handles à diffuser en continu des ressources cibles de sortie qui représente la différence entre le nombre précédent de ressources cibles de sortie de flux (avant que le runtime Microsoft Direct3D appelle SoSetTargets) et le nouveau nombre de ressources cibles de sortie de flux.

Notez que le nombre spécifié par iClearTargets n’est qu’une aide à l’optimisation, car le pilote d’affichage en mode utilisateur peut calculer ce nombre.

unnamedParam4

phResource [in]

Tableau de handles pour les ressources cibles de sortie de flux à définir. Notez que certaines valeurs de handle peuvent être NULL.

unnamedParam5

pOffsets [in]

Tableau de décalages, en octets, dans les ressources cibles de sortie de flux dans le tableau spécifié par phResource .

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

La plage de ressources cibles de sortie de flux entre le nombre spécifié par le paramètre SOTargets et le nombre maximal de ressources cibles de sortie de flux autorisées doit contenir toutes les valeurs NULL ou indépendantes. Le nombre spécifié par le paramètre ClearTargets informe le pilote du nombre de points de liaison que le pilote doit effacer pour l’opération en cours. Si l’appel précédent à SoSetTargets a passé la valeur 2 dans SOTargetset que l’appel actuel à SoSetTargets passe la valeur 4 dans SOTargets, l’appel actuel à SoSetTargets passe également une valeur de 0 dans le paramètre ClearTargets . Si l’appel successif suivant à SoSetTargets passe la valeur 1 dans SOTargets, l’appel successif passe également la valeur 3 (4 - 1) dans ClearTargets.

Le pilote ne doit rencontrer aucune erreur, à l’exception de D3DDDIERR_DEVICEREMOVED. Par conséquent, si le pilote réussit une erreur, à l’exception de D3DDDIERR_DEVICEREMOVED, dans un appel à la fonction pfnSetErrorCb , le runtime Microsoft Direct3D détermine que l’erreur est critique. Même si l’appareil a été supprimé, le pilote n’est pas tenu de retourner D3DDDIERR_DEVICEREMOVED ; Toutefois, si la suppression de l’appareil interfère avec le fonctionnement de SOTargets (ce qui ne doit généralement pas se produire), le pilote peut retourner D3DDDIERR_DEVICEREMOVED.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb