Método IDXGIObject::GetPrivateData (dxgi.h)

  • Artigo

Obtenha um ponteiro para os dados do objeto.

Sintaxe

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

Parâmetros

[in] Name

Tipo: REFGUID

Um GUID que identifica os dados.

[in, out] pDataSize

Tipo: UINT*

O tamanho dos dados.

[out] pData

Tipo: void*

Ponteiro para os dados.

Valor retornado

Tipo: HRESULT

Retorna um dos DXGI_ERROR a seguir.

Comentários

Se os dados retornados forem um ponteiro para um IUnknown ou uma de suas classes derivadas, definidas anteriormente por IDXGIObject::SetPrivateDataInterface, você deverá chamar ::Release() no ponteiro antes que o ponteiro seja liberado para diminuir a contagem de referência.

Você pode passar GUID_DeviceType no parâmetro Name de GetPrivateData para recuperar o tipo de dispositivo do objeto do adaptador de exibição (IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2).

Para obter o tipo de dispositivo no qual o adaptador de exibição foi criado

  1. Chame IUnknown::QueryInterface no objeto ID3D11Device ou ID3D10Device para recuperar o objeto IDXGIDevice .
  2. Chame GetParent no objeto IDXGIDevice para recuperar o objeto IDXGIAdapter .
  3. Chame GetPrivateData no objeto IDXGIAdapter com GUID_DeviceType para recuperar o tipo de dispositivo no qual o adaptador de exibição foi criado. pData apontará para um valor da enumeração do tipo driver (por exemplo, um valor de D3D_DRIVER_TYPE).
No Windows 7 ou anterior, esse tipo é um valor de D3D10_DRIVER_TYPE ou D3D_DRIVER_TYPE dependendo de qual tipo de dispositivo foi criado. No Windows 8, esse tipo é sempre um valor de D3D_DRIVER_TYPE. Não use IDXGIObject::SetPrivateData com GUID_DeviceType porque o comportamento ao fazer isso é indefinido.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

DXGI Interfaces

IDXGIObject