IDXGIObject::GetPrivateData 메서드(dxgi.h)

개체의 데이터에 대한 포인터를 가져옵니다.

구문

HRESULT GetPrivateData(
  [in]      REFGUID Name,
  [in, out] UINT    *pDataSize,
  [out]     void    *pData
);

매개 변수

[in] Name

형식: REFGUID

데이터를 식별하는 GUID입니다.

[in, out] pDataSize

형식: UINT*

데이터의 크기입니다.

[out] pData

형식: void*

데이터에 대한 포인터입니다.

반환 값

형식: HRESULT

다음 DXGI_ERROR 중 하나를 반환합니다.

설명

반환된 데이터가 IUnknown에 대한 포인터이거나 이전에 IDXGIObject::SetPrivateDataInterface로 설정된 파생 클래스 중 하나인 경우 포인터가 해제되기 전에 포인터에서 ::Release() 를 호출하여 참조 수를 줄여야 합니다.

GetPrivateData의 Name 매개 변수에 GUID_DeviceType 전달하여 디스플레이 어댑터 개체(IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2)에서 디바이스 유형을 검색할 수 있습니다.

디스플레이 어댑터를 만든 디바이스 유형을 얻으려면

1. ID3D11Device 또는 ID3D10Device 개체에서 IUnknown::QueryInterface를 호출하여 IDXGIDevice 개체를 검색합니다.
2. IDXGIDevice 개체에서 GetParent를 호출하여 IDXGIAdapter 개체를 검색합니다.
3. GUID_DeviceType 사용하여 IDXGIAdapter 개체에서 GetPrivateData를 호출하여 디스플레이 어댑터가 만들어진 디바이스 유형을 검색합니다. pData 는 드라이버 형식 열거형의 값(예: D3D_DRIVER_TYPE 값)을 가리킵니다.

Windows 7 이전 버전에서 이 형식은 생성된 디바이스 종류에 따라 D3D10_DRIVER_TYPE 값이거나 D3D_DRIVER_TYPE 값입니다. Windows 8에서 이 형식은 항상 D3D_DRIVER_TYPE 값입니다. idXGIObject::SetPrivateData를 GUID_DeviceType 사용하지 마세요. 이렇게 할 때의 동작이 정의되지 않았기 때문입니다.

요구 사항

대상 플랫폼	Windows
헤더	dxgi.h
라이브러리	DXGI.lib

추가 정보

DXGI 인터페이스

IDXGIObject