PFND3DDDI_CREATEDEVICE fonction de rappel (d3dumddi.h)
La fonction CreateDevice crée un contexte graphique référencé dans les appels suivants.
Syntaxe
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
Paramètres
hAdapter
Handle qui identifie l’adaptateur graphique.
unnamedParam2
pCreateData [in, out]
Pointeur vers une structure D3DDDIARG_CREATEDEVICE. Lors de l’entrée, cette structure contient des informations que le pilote peut utiliser. En sortie, le pilote spécifie des informations dans la structure que le runtime Microsoft Direct3D peut utiliser.
Valeur de retour
CreateDevice retourne l’une des valeurs suivantes :
| code de retour | Description |
|---|---|
| S_OK | Le contexte graphique est correctement créé. |
| E_OUTOFMEMORY | CreateDevice n’a pas pu allouer la mémoire nécessaire pour qu’elle soit terminée. |
Remarques
Un appareil d’affichage est un contexte graphique utilisé pour contenir une collection d’états de rendu. Plusieurs appareils peuvent être créés par le même processus sur un adaptateur donné. Notez que le nombre d’appareils d’affichage pouvant exister simultanément est limité uniquement par la mémoire système disponible. Autrement dit, un pilote ne peut pas coder en dur une limite maximale de périphérique.
En règle générale, les appareils sont indépendants les uns des autres, de sorte que les ressources créées dans un appareil ne peuvent pas être référencées ou accessibles par les ressources créées dans un autre. Toutefois, les ressources interprocesseur sont une exception à cette règle.
Lorsque le runtime Direct3D appelle CreateDevice pour créer un appareil, le runtime ne crée pas de thread de contexte d’unité de traitement graphique (GPU) par défaut pour l’appareil. Le pilote doit appeler explicitement la fonction pfnCreateContextCb pour créer un ou plusieurs contextes selon les besoins.
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 | d3dumddi.h (include D3dumddi.h) |