ID3D11Device::SetPrivateData 메서드(d3d11.h)

데이터를 디바이스로 설정하고 해당 데이터를 guid와 연결합니다.

구문

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

매개 변수

[in] guid

형식: REFGUID

데이터와 연결된 Guid입니다.

[in] DataSize

형식: UINT

데이터의 크기입니다.

[in, optional] pData

형식: const void*

이 디바이스와 함께 저장할 데이터에 대한 포인터입니다. pData가 NULL이면 DataSize도 0이어야 하며 이전에 guid와 연결된 모든 데이터가 제거됩니다.

반환 값

형식: HRESULT

이 메서드는 다음 Direct3D 11 반환 코드 중 하나를 반환합니다.

설명

이 메서드를 사용하여 디바이스에 저장된 데이터는 ID3D11Device::GetPrivateData를 사용하여 검색할 수 있습니다.

이 메서드를 사용하여 설정된 데이터 및 guid는 일반적으로 애플리케이션에서 정의됩니다.

디버그 계층은 친숙한 이름과 함께 개체 인터페이스 포인터 목록을 출력하여 메모리 누수에 대해 보고합니다. 기본 식별 이름은 "<이름 없음>"입니다. 식별 이름을 설정하여 해당 개체 인터페이스 포인터가 누수의 원인이 되었는지 확인할 수 있습니다. 이름을 설정하려면 SetPrivateData 메서드와 D3Dcommon.h에 있는 WKPDID_D3DDebugObjectName GUID를 사용합니다. 예를 들어 pContext에 내 이름의 이름을 지정하려면 다음 코드를 사용합니다.

static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d3d11.h
라이브러리	D3D11.lib

추가 정보

ID3D11Device