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 |