PFND3DDDI_CREATECONTEXTCB fonction de rappel (d3dumddi.h)
La fonction de rappel pfnCreateContextCb du runtime Direct3D crée un contexte.
Syntaxe
PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;
HRESULT Pfnd3dddiCreatecontextcb(
HANDLE hDevice,
D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}
Paramètres
hDevice
[in] Gérez l’appareil pour lequel le contexte doit être créé.
unnamedParam2
[in/out] Pointeur vers une structure D3DDDICB_CREATECONTEXT que le pilote remplit avec les informations nécessaires pour créer le contexte. Cette structure inclut des détails tels que l’ordinal de nœud, l’affinité du moteur et les indicateurs qui spécifient le comportement et les fonctionnalités du contexte à créer. Une fois l’exécution terminée, le runtime met à jour cette structure avec des informations sur le contexte nouvellement créé.
Valeur de retour
pfnCreateContextCb retourne un HRESULT pour indiquer la réussite ou l’échec de la demande de création de contexte. Les valeurs de retour courantes sont les suivantes :
| Retourner le code | Signification |
|---|---|
| S_OK | Le contexte a été créé avec succès. |
| E_OUTOFMEMORY | La mémoire est insuffisante pour créer le contexte. |
| E_INVALIDARG | Un ou plusieurs arguments fournis ne sont pas valides. |
Remarques
Le pilote d’affichage en mode utilisateur (UMD) doit appeler explicitement pfnCreateContextCb à partir de son implémentation CreateDevice pour créer un contexte GPU associé à l’appareil. Les contextes GPU sont des threads d’exécution GPU sur un appareil nouvellement créé.
Le contexte encapsule les mémoires tampons d’état et de commande que le GPU utilise pour effectuer des opérations de rendu. UMD est responsable de la gestion du cycle de vie des contextes qu’il crée, y compris leur destruction éventuelle pour libérer des ressources.
Pour plus d’informations sur la création d’un appareil de rendu, consultez flux d’opération WDDM (Windows Display Driver Model).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista (WDDM 1.0) |
| d’en-tête | d3dumddi.h |