IDXGIObject::GetPrivateData-Methode (dxgi.h)

  • Artikel

Rufen Sie einen Zeiger auf die Daten des Objekts ab.

Syntax

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

Parameter

[in] Name

Typ: REFGUID

Eine GUID, die die Daten identifiziert.

[in, out] pDataSize

Typ: UINT*

Die Größe der Daten.

[out] pData

Typ: void*

Zeiger auf die Daten.

Rückgabewert

Typ: HRESULT

Gibt eine der folgenden DXGI_ERROR zurück.

Hinweise

Wenn die zurückgegebenen Daten ein Zeiger auf einen IUnknown oder eine seiner abgeleiteten Klassen sind, die zuvor von IDXGIObject::SetPrivateDataInterface festgelegt wurden, müssen Sie ::Release() auf dem Zeiger aufrufen, bevor der Zeiger frei ist, um die Verweisanzahl zu verringern.

Sie können GUID_DeviceType im Name-Parameter von GetPrivateData übergeben, um den Gerätetyp aus dem Anzeigeadapterobjekt abzurufen (IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2).

So rufen Sie den Gerätetyp ab, auf dem die Grafikkarte erstellt wurde

  1. Rufen Sie IUnknown::QueryInterface für das ID3D11Device- oder ID3D10Device-Objekt auf, um das IDXGIDevice-Objekt abzurufen.
  2. Rufen Sie GetParent für das IDXGIDevice-Objekt auf, um das IDXGIAdapter-Objekt abzurufen.
  3. Rufen Sie GetPrivateData für das IDXGIAdapter-Objekt mit GUID_DeviceType auf, um den Gerätetyp abzurufen, auf dem die Grafikkarte erstellt wurde. pData zeigt auf einen Wert aus der Treibertyp-Enumeration (z. B. einen Wert aus D3D_DRIVER_TYPE).
Unter Windows 7 oder früher ist dieser Typ entweder ein Wert aus D3D10_DRIVER_TYPE oder D3D_DRIVER_TYPE , je nachdem, welche Art von Gerät erstellt wurde. Unter Windows 8 ist dieser Typ immer ein Wert aus D3D_DRIVER_TYPE. Verwenden Sie IDXGIObject::SetPrivateData nicht mit GUID_DeviceType , da das Verhalten dabei nicht definiert ist.

Anforderungen

   
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIObject