PFND3D10DDI_CREATERASTERIZERSTATE fonction de rappel (d3d10umddi.h)
La fonction CreateRasterizerState crée un état de rastériseur.
Syntaxe
PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;
void Pfnd3d10ddiCreaterasterizerstate(
D3D10DDI_HDEVICE unnamedParam1,
const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
D3D10DDI_HRASTERIZERSTATE unnamedParam3,
D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}
Paramètres
unnamedParam1
hDevice [in]
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pRasterizerDesc [in]
Pointeur vers une structure D3D10_DDI_RASTERIZER_DESC qui décrit les paramètres utilisés par le pilote d’affichage en mode utilisateur pour créer un état de rastériseur.
unnamedParam3
hRasterizerState [in]
Handle des données privées du pilote pour l’état de rastériseur. 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 d’un appel à la fonction CalcPrivateRasterizerStateSize 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 d’état de rastériseur.
unnamedParam4
hRTRasterizerState [in]
Handle à l’état de rastériseur 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 DestroyRasterizerState pour détruire le handle spécifié par le paramètre hRasterizerState.
Le pilote d’affichage en mode utilisateur n’est pas nécessaire pour créer plus de 4 096 instances uniques d’objets à état ratériseur 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) |