Metodo ID3D11DeviceChild::SetPrivateData (d3d11.h)

Impostare i dati definiti dall'applicazione su un elemento figlio del dispositivo e associare tali dati a un GUID definito dall'applicazione.

Sintassi

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

Parametri

[in] guid

Tipo: REFGUID

GUID associato ai dati.

[in] DataSize

Tipo: UINT

Dimensioni dei dati.

[in, optional] pData

Tipo: const void*

Puntatore ai dati da archiviare con questo dispositivo figlio. Se pData è NULL, Anche DataSize deve essere 0 e tutti i dati precedentemente associati al GUID specificato verranno eliminati definitivamente.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 11 seguenti.

Commenti

I dati archiviati nel dispositivo figlio con questo metodo possono essere recuperati con ID3D11DeviceChild::GetPrivateData.

Il livello di debug segnala perdite di memoria tramite l'output di un elenco di puntatori all'interfaccia oggetto insieme ai relativi nomi descrittivi. Il nome descrittivo> predefinito è "<senza nome". È possibile impostare il nome descrittivo in modo che sia possibile determinare se il puntatore all'interfaccia dell'oggetto corrispondente ha causato la perdita. Per impostare il nome descrittivo, usare il metodo SetPrivateData e il GUID WKPDID_D3DDebugObjectName in D3Dcommon.h. Ad esempio, per assegnare a pContext un nome descrittivo di Nome personale, usare il codice seguente:

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d11.h
Libreria	D3D11.lib

Vedi anche

ID3D11DeviceChild