Compartir a través de


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

Establezca los datos definidos por la aplicación en un elemento secundario del dispositivo y asocie esos datos a un guid definido por la aplicación.

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 almacenarán con este elemento secundario del dispositivo. Si pData es NULL, DataSize también debe ser 0 y se destruirán los datos asociados previamente con el guid especificado.

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 elemento secundario del dispositivo con este método se pueden recuperar con ID3D11DeviceChild::GetPrivateData.

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

ID3D11DeviceChild