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

  • Article

Définissez les données définies par l’application sur un enfant d’appareil et associez ces données à un GUID défini par l’application.

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 enfant. Si pData a la valeur NULL, DataSize doit également avoir la valeur 0, et toutes les données précédemment associées au GUID spécifié 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 enfant avec cette méthode peuvent être récupérées avec ID3D11DeviceChild ::GetPrivateData.

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

ID3D11DeviceChild