PFND3DDDI_CREATEDEVICE fonction de rappel (d3dumddi.h)

  • Article

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 la carte graphique.

unnamedParam2

pCreateData [in, out]

Pointeur vers une structure D3DDDIARG_CREATEDEVICE . En entrée, cette structure contient des informations que le pilote peut utiliser. Lors de la sortie, le pilote spécifie des informations dans la structure que le runtime Microsoft Direct3D peut utiliser.

Valeur retournée

CreateDevice retourne l’une des valeurs suivantes :

Code de retour Description
S_OK Le contexte graphique est créé avec succès.
E_OUTOFMEMORY CreateDevice n’a pas pu allouer la mémoire nécessaire pour qu’il se termine.

Remarques

Un périphérique d’affichage est un contexte graphique utilisé pour contenir une collection d’état de rendu. Plusieurs appareils peuvent être créés par le même processus sur un adaptateur donné. Notez que le nombre de périphériques 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ériques.

En règle générale, les appareils étant indépendants les uns des autres, 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 interprocesseurs 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 en fonction des besoins.

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 d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice