ID3D11Device ::SetPrivateData, méthode (d3d11.h)

Définissez les données sur un appareil et associez ces données à un GUID.

Syntaxe

HRESULT SetPrivateData(
  [in]           REFGUID    guid,
  [in]           UINT       DataSize,
  [in, optional] const void *pData
);

Paramètres

[in] guid

Type : REFGUID

GUID associé aux données.

[in] DataSize

Type : UINT

Taille des données.

[in, optional] pData

Type : const void*

Pointeur vers les données à stocker avec cet appareil. Si pData a la valeur NULL, DataSize doit également être 0, et toutes les données précédemment associées au GUID sont détruites.

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 11 suivants.

Remarques

Les données stockées dans l’appareil avec cette méthode peuvent être récupérées avec ID3D11Device ::GetPrivateData.

Le jeu de données et de GUID avec cette méthode est généralement défini par l’application.

La couche de débogage signale les fuites de mémoire en mettant une liste de pointeurs d’interface d’objet avec leurs noms conviviaux. Le nom convivial par défaut est «< sans nom> ». Vous pouvez définir le nom convivial afin de déterminer si le pointeur d’interface objet correspondant a provoqué la fuite. Pour définir le nom convivial, utilisez la méthode SetPrivateData et le GUID WKPDID_D3DDebugObjectName qui se trouve dans D3Dcommon.h. Par exemple, pour donner à pContext un nom convivial Mon nom, utilisez le code suivant :

static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d11.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11Device