Método ID3D11Device::SetPrivateData (d3d11.h)

  • Artículo

Establezca los datos en un dispositivo y asócielos a un guid.

Sintaxis

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

Parámetros

[in] guid

Tipo: REFGUID

Guid asociado a los datos.

[in] DataSize

Tipo: UINT

Tamaño de los datos.

[in, optional] pData

Tipo: const void*

Puntero a los datos que se van a almacenar con este dispositivo. Si pData es NULL, DataSize también debe ser 0 y se destruirán los datos asociados previamente con el guid.

Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los siguientes códigos de retorno de Direct3D 11.

Comentarios

Los datos almacenados en el dispositivo con este método se pueden recuperar con ID3D11Device::GetPrivateData.

Los datos y el conjunto guid con este método normalmente se definirán por la aplicación.

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 interfaz de objeto correspondiente provocó la fuga. Para establecer el nombre descriptivo, use el método SetPrivateData y el GUID de 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 );

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d11.h
Library D3D11.lib

Consulte también

ID3D11Device