Metodo ID3D11Device::SetPrivateData (d3d11.h)

Impostare i dati su un dispositivo e associare i dati a un GUID.

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. Se pData è NULL, Anche DataSize deve essere 0 e tutti i dati precedentemente associati al GUID verranno eliminati definitivamente.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce uno dei codici restituiti Direct3D 11 seguenti.

Commenti

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

I dati e i GUID impostati con questo metodo verranno in genere definiti dall'applicazione.

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

ID3D11Device