IDirect3D9::GetAdapterIdentifier メソッド (d3d9helper.h)
IDirect3D9 インターフェイスがインスタンス化されたときにシステムに存在する物理ディスプレイ アダプターについて説明します。
構文
HRESULT GetAdapterIdentifier(
[in] UINT Adapter,
[in] DWORD Flags,
[out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);
パラメーター
[in] Adapter
型: UINT
ディスプレイ アダプターを表す序数。 D3DADAPTER_DEFAULTは常にプライマリ ディスプレイ アダプターです。 このパラメーターの最小値は 0 で、このパラメーターの最大値は GetAdapterCount によって返される値より 1 小さい値です。
[in] Flags
型: DWORD
Flags は、D3DADAPTER_IDENTIFIER9の WHQLLevel メンバーを設定します。 フラグは、0 またはD3DENUM_WHQL_LEVELに設定できます。 D3DENUM_WHQL_LEVELが指定されている場合、この呼び出しはインターネットに接続して、新しい Microsoft Windows Hardware Quality Labs (WHQL) 証明書をダウンロードできます。
Direct3D 9 と Direct3D 9Ex の違い:
D3DENUM_WHQL_LEVELは、Windows Vista、Windows Server 2008、Windows 7、および Windows Server 2008 R2 (またはそれ以上の現在のオペレーティング システム) で実行されている Direct3D9Ex では非推奨です。 これらのオペレーティング システムは、ドライバーの状態を確認せずに、D3DADAPTER_IDENTIFIER9の WHQLLevel メンバーで 1 を返します。
[out] pIdentifier
このアダプターを説明する情報が入力される D3DADAPTER_IDENTIFIER9 構造体へのポインター。 アダプターがシステム内のアダプターの数以上の場合、この構造体はゼロになります。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 アダプターが範囲外の場合、フラグに認識されないパラメーターが含まれている場合、または pIdentifier が NULL であるか、書き込み不可能なメモリを指している場合は、D3DERR_INVALIDCALLが返されます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | d3d9helper.h (D3D9.h を含む) |
Library | D3D9.lib |