Metodo IDXGIObject::GetPrivateData (dxgi.h)

  • Articolo

Ottiene un puntatore ai dati dell'oggetto.

Sintassi

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

Parametri

[in] Name

Tipo: REFGUID

GUID che identifica i dati.

[in, out] pDataSize

Tipo: UINT*

Dimensione dei dati.

[out] pData

Tipo: void*

Puntatore ai dati.

Valore restituito

Tipo: HRESULT

Restituisce uno dei DXGI_ERROR seguenti.

Commenti

Se i dati restituiti sono un puntatore a un oggetto IUnknown o a una delle relative classi derivate, precedentemente impostate da IDXGIObject::SetPrivateDataInterface, è necessario chiamare ::Release() sul puntatore prima che il puntatore venga liberato per decrementare il conteggio dei riferimenti.

È possibile passare GUID_DeviceType nel parametro Name di GetPrivateData per recuperare il tipo di dispositivo dall'oggetto adattatore di visualizzazione (IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2).

Per ottenere il tipo di dispositivo in cui è stata creata la scheda di visualizzazione

  1. Chiamare IUnknown::QueryInterface sull'oggetto ID3D11Device o ID3D10Device per recuperare l'oggetto IDXGIDevice .
  2. Chiamare GetParent sull'oggetto IDXGIDevice per recuperare l'oggetto IDXGIAdapter .
  3. Chiamare GetPrivateData sull'oggetto IDXGIAdapter con GUID_DeviceType per recuperare il tipo di dispositivo in cui è stata creata la scheda di visualizzazione. pData punterà a un valore dell'enumerazione di tipo driver, ad esempio un valore di D3D_DRIVER_TYPE.
In Windows 7 o versioni precedenti, questo tipo è un valore di D3D10_DRIVER_TYPE o D3D_DRIVER_TYPE a seconda del tipo di dispositivo creato. In Windows 8 questo tipo è sempre un valore di D3D_DRIVER_TYPE. Non usare IDXGIObject::SetPrivateData con GUID_DeviceType perché il comportamento quando si esegue questa operazione non è definito.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione dxgi.h
Libreria DXGI.lib

Vedi anche

Interfacce DXGI

IDXGIObject