PFND3D11_1DDI_ASSIGNDEBUGBINARY fonction de rappel (d3d10umddi.h)

Article
02/26/2024

Fournit le fichier binaire de nuanceur complet disponible après la création du nuanceur. Le fichier binaire de nuanceur complet permet à un pilote de récupérer des informations de débogage ou d’autres informations binaires de nuanceur qui ne seraient normalement pas disponibles pour le pilote.

Syntaxe

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

void Pfnd3d111DdiAssigndebugbinary(
       D3D10DDI_HDEVICE unnamedParam1,
       D3D10DDI_HSHADER unnamedParam2,
       UINT uBinarySize,
  [in] const VOID *pBinary
)
{...}

Paramètres

unnamedParam1

hDevice [in]

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

hShader [in]

Handle des données privées du pilote pour l’objet nuanceur.

uBinarySize

Taille, en octets, du binaire du nuanceur complet.

[in] pBinary

Pointeur vers le binaire de nuanceur complet.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

AssignDebugBinary est appelé uniquement si tous les éléments suivants sont true :

L’appareil peut être débogué.
Le pilote d’affichage en mode utilisateur a défini le D3D11_1DDI_D3D11_OPTIONS_DATA. AssignDebugBinarySupport indicateur à TRUE.
Une fonction de création de nuanceur CreateXxxShaderXxx a été appelée, a réussi et a retourné un handle au nuanceur.

Le pilote ne doit rencontrer aucune erreur, à l’exception de D3DDDIERR_DEVICEREMOVED. Par conséquent, si le pilote réussit une erreur, à l’exception de D3DDDIERR_DEVICEREMOVED, dans un appel à la fonction pfnSetErrorCb , le runtime Microsoft Direct3D détermine que l’erreur est critique. Même si l’appareil a été supprimé, le pilote n’est pas tenu de retourner D3DDDIERR_DEVICEREMOVED ; toutefois, si la suppression de l’appareil a interférer avec l’opération AssignDebugBinary (ce qui ne doit généralement pas se produire), le pilote peut retourner D3DDDIERR_DEVICEREMOVED.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb

Partager via