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