IDXGIObject::GetPrivateData method (dxgi.h)

  • Artikel

Dapatkan penunjuk ke data objek.

Sintaks

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

Parameter

[in] Name

Jenis: REFGUID

GUID yang mengidentifikasi data.

[in, out] pDataSize

Jenis: UINT*

Ukuran data.

[out] pData

Jenis: batal*

Arahkan ke data.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan salah satu DXGI_ERROR berikut.

Keterangan

Jika data yang dikembalikan adalah penunjuk ke IUnknown, atau salah satu kelas turunannya, yang sebelumnya ditetapkan oleh IDXGIObject::SetPrivateDataInterface, Anda harus memanggil ::Release() pada pointer sebelum pointer dibebaskan untuk mengurangi jumlah referensi.

Anda dapat meneruskan GUID_DeviceType dalam parameter NamaGetPrivateData untuk mengambil jenis perangkat dari objek adaptor tampilan (IDXGIAdapter, IDXGIAdapter1, IDXGIAdapter2).

Untuk mendapatkan jenis perangkat tempat adaptor tampilan dibuat

  1. Panggil objek IUnknown::QueryInterface pada objek ID3D11Device atau ID3D10Device untuk mengambil objek IDXGIDevice .
  2. Panggil GetParent pada objek IDXGIDevice untuk mengambil objek IDXGIAdapter .
  3. Panggil GetPrivateData pada objek IDXGIAdapter dengan GUID_DeviceType untuk mengambil jenis perangkat tempat adaptor tampilan dibuat. pData akan menunjuk ke nilai dari enumerasi jenis driver (misalnya, nilai dari D3D_DRIVER_TYPE).
Pada Windows 7 atau yang lebih lama, jenis ini adalah nilai dari D3D10_DRIVER_TYPE atau D3D_DRIVER_TYPE tergantung jenis perangkat mana yang dibuat. Pada Windows 8, jenis ini selalu merupakan nilai dari D3D_DRIVER_TYPE. Jangan gunakan IDXGIObject::SetPrivateData dengan GUID_DeviceType karena perilaku saat melakukannya tidak terdefinisi.

Persyaratan

   
Target Platform Windows
Header dxgi.h
Pustaka DXGI.lib

Lihat juga

Antarmuka DXGI

IDXGIObject