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を返します。

解説

返されるデータが、IDXGIObject::SetPrivateDataInterface によって以前に設定された IUnknown またはその派生クラスへのポインターである場合は、ポインターが解放される前にポインターで ::Release() を呼び出して参照カウントをデクリメントする必要があります。

GetPrivateData の Name パラメーターにGUID_DeviceTypeを渡して、ディスプレイ アダプター オブジェクト (IDXGIAdapter、IDXGIAdapter1、IDXGIAdapter2) からデバイスの種類を取得できます。

ディスプレイ アダプターが作成されたデバイスの種類を取得するには

1. ID3D11Device オブジェクトまたは ID3D10Device オブジェクトで IUnknown::QueryInterface を呼び出して、IDXGIDevice オブジェクトを取得します。
2. IDXGIAdapter オブジェクトを取得するには、IDXGIDevice オブジェクトで GetParent を呼び出します。
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
Library	DXGI.lib

関連項目

DXGI インターフェイス

IDXGIObject