Win32 API 日本語リファレンス
ホーム › Graphics.Direct3D9 › IDirect3DSwapChain9Ex

IDirect3DSwapChain9Ex

COM
📘 Microsoft Learn (日本語) · English
IID91886caf-1c3d-4d2e-a0ab-3e4c7d8d3303継承元IDirect3DSwapChain9自前メソッド開始 vtbl10

公式ドキュメント

アプリケーションは、IDirect3DSwapChain9Ex インターフェイスのメソッドを使用してスワップチェーンを操作します。

解説(Remarks)

各デバイスには常に少なくとも 1 つのスワップチェーン(暗黙のスワップチェーン)が存在します。ただし、同一デバイスから複数のビューをレンダリングするための追加のスワップチェーンを、CreateAdditionalSwapChain メソッドを呼び出して作成することもできます。

このインターフェイスは、すべての COM インターフェイスと同様に、IUnknown インターフェイスを継承します。

LPDIRECT3DSWAPCHAIN9 型および PDIRECT3DSWAPCHAIN9 型は、IDirect3DSwapChain9 インターフェイスへのポインターとして定義されています。

IDirect3DSwapChain9Ex オブジェクトは、IDirect3DDevice9Ex のインスタンスに対して GetSwapChain を呼び出した際に、IDirect3DSwapChain9 オブジェクトへのポインターとして返されます。 IDirect3DSwapChain9Ex インターフェイスは、GetSwapChain によって返された IDirect3DSwapChain9 のインスタンスに対して QueryInterface を呼び出すことで取得します。

メソッド 3

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 10 HRESULT GetLastPresentCount(DWORD* pLastPresentCount)

スワップチェーンが処理された回数を返します。

pLastPresentCountDWORD*inoutIDirect3DDevice9Ex::PresentEx メソッドが呼び出された回数が格納される UINT へのポインターです。このカウントは、IDirect3DDevice9::SetDialogBoxMode など他の一部の API を呼び出した場合にも増加します。

戻り値

型: HRESULT

メソッドが成功した場合は S_OK が返されます。

vtbl 11 HRESULT GetPresentStats(D3DPRESENTSTATS* pPresentationStatistics)
pPresentationStatisticsD3DPRESENTSTATS*inoutプレゼンテーション統計を受け取るD3DPRESENTSTATSへのポインタ。
vtbl 12 HRESULT GetDisplayModeEx(D3DDISPLAYMODEEX* pMode, D3DDISPLAYROTATION* pRotation)

ディスプレイモードの空間解像度、色解像度、リフレッシュ周波数、および回転設定を取得します。(IDirect3DSwapChain9Ex.GetDisplayModeEx)

pModeD3DDISPLAYMODEEX*inoutアダプターのディスプレイモードに関するデータを格納する D3DDISPLAYMODEEX 構造体へのポインターです。これはデバイスのディスプレイモードとは異なり、デバイスがフルスクリーンモードを所有していない場合はアクティブでない可能性があります。
pRotationD3DDISPLAYROTATION*inoutアプリケーションが行う画面回転の種類を示す D3DDISPLAYROTATION へのポインターです。このポインターを通じて返される値は、D3DPRESENTFLAG_NOAUTOROTATE フラグを使用する場合に重要です。それ以外の場合は NULL を設定できます。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になることがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IDirect3DSwapChain9Ex "{91886CAF-1C3D-4D2E-A0AB-3E4C7D8D3303}"
#usecom global IDirect3DSwapChain9Ex IID_IDirect3DSwapChain9Ex "{}"
#comfunc global IDirect3DSwapChain9Ex_GetLastPresentCount  10 var
#comfunc global IDirect3DSwapChain9Ex_GetPresentStats      11 var
#comfunc global IDirect3DSwapChain9Ex_GetDisplayModeEx     12 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。