PFND3D10DDI_CREATESAMPLER fonction de rappel (d3d10umddi.h)

  • Article

La fonction CreateSampler crée un échantillonneur.

Syntaxe

PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;

void Pfnd3d10ddiCreatesampler(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
  D3D10DDI_HSAMPLER unnamedParam3,
  D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}

Paramètres

unnamedParam1

hDevice [in]

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

unnamedParam2

pSamplerDesc [in]

Pointeur vers une structure D3D10_DDI_SAMPLER_DESC qui décrit les paramètres que le pilote d’affichage en mode utilisateur utilise pour créer un échantillonneur.

unnamedParam3

hSampler [in]

Handle pour les données privées du pilote pour l’échantillonneur. Le pilote retourne la taille, en octets, de la région de mémoire que le runtime Microsoft Direct3D doit allouer pour les données privées à partir d’un appel à la fonction CalcPrivateSamplerSize du pilote. Le handle n’est en fait qu’un pointeur vers une région de mémoire, dont le pilote a demandé la taille. Le pilote utilise cette région de mémoire pour stocker les structures de données internes liées à son objet sampler.

unnamedParam4

hRTSampler [in]

Handle de l’échantillonneur que le pilote doit utiliser chaque fois qu’il rappelle le runtime Direct3D.

Valeur de retour

None

Remarques

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

Le pilote peut passer E_OUTOFMEMORY (si le pilote manque de mémoire) ou D3DDDIERR_DEVICEREMOVED (si le périphérique a été supprimé) dans un appel à la fonction pfnSetErrorCb . Le runtime Direct3D détermine que toutes les autres erreurs sont critiques. Si le pilote transmet des erreurs, y compris D3DDDIERR_DEVICEREMOVED, le runtime Direct3D détermine que le handle n’est pas valide ; Par conséquent, le runtime n’appelle pas la fonction DestroySampler pour détruire le handle spécifié par le paramètre hSampler .

Le pilote d’affichage en mode utilisateur n’est pas nécessaire pour créer plus de 4 096 instances uniques d’objets sampler sur un appareil à la fois.

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

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb