Método IDXGIObject::SetPrivateData (dxgi.h)
Establece los datos definidos por la aplicación en el objeto y asocia esos datos a un GUID.
Sintaxis
HRESULT SetPrivateData(
[in] REFGUID Name,
UINT DataSize,
[in] const void *pData
);
Parámetros
[in] Name
Tipo: REFGUID
GUID que identifica los datos. Use este GUID en una llamada a GetPrivateData para obtener los datos.
DataSize
Tipo: UINT
Tamaño de los datos del objeto.
[in] pData
Tipo: const void*
Puntero a los datos del objeto.
Valor devuelto
Tipo: HRESULT
Devuelve uno de los valores de DXGI_ERROR .
Comentarios
SetPrivateData realiza una copia de los datos especificados y los almacena con el objeto .
Los datos privados que SetPrivateData almacena en el objeto ocupan el mismo espacio de almacenamiento que los datos privados almacenados por objetos direct3D asociados (por ejemplo, por un dispositivo de Microsoft Direct3D 11 a través de ID3D11Device::SetPrivateData o por un dispositivo secundario de Direct3D 11 a través de ID3D11DeviceChild::SetPrivateData).
La capa de depuración notifica pérdidas de memoria mediante la salida de una lista de punteros de interfaz de objeto junto con sus nombres descriptivos. El nombre descriptivo predeterminado es "<sin nombre>". Puede establecer el nombre descriptivo para que pueda determinar si el puntero de la interfaz de objeto correspondiente causó la fuga. Para establecer el nombre descriptivo, use el método SetPrivateData y el GUID de datos privados conocidos (WKPDID_D3DDebugObjectName) que se encuentra en D3Dcommon.h. Por ejemplo, para asignar a pContext un nombre descriptivo de Mi nombre, use el código siguiente:
static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );
Puede usar WKPDID_D3DDebugObjectName para realizar un seguimiento de las pérdidas de memoria y comprender las características de rendimiento de las aplicaciones. Esta información se refleja en la salida de la capa de depuración relacionada con las fugas de memoria (ID3D11Debug::ReportLiveDeviceObjects) y con el seguimiento de eventos para eventos de Windows que hemos agregado a Windows 8.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | dxgi.h |
| Library | DXGI.lib |