PFND3D10DDI_CREATESAMPLER fonction de rappel (d3d10umddi.h)
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 de l’appareil d’affichage (contexte graphique).
unnamedParam2
pSamplerDesc [in]
Pointeur vers une structure D3D10_DDI_SAMPLER_DESC qui décrit les paramètres utilisés par le pilote d’affichage en mode utilisateur pour créer un échantillonneur.
unnamedParam3
hSampler [in]
Handle des 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 est vraiment un pointeur vers une région de mémoire, la taille de laquelle le pilote a demandé. Le pilote utilise cette région de mémoire pour stocker des 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 revient dans le runtime Direct3D.
Valeur de retour
Aucun
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 l’appareil 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |