D3DKMTEnumAdapters2 関数 (d3dkmthk.h)

  • [アーティクル]

D3DKMTEnumAdapters2 関数は、システム上のすべてのグラフィックスおよびディスプレイ アダプターを列挙するための情報を提供します。

構文

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

パラメーター

unnamedParam1

[入力、出力]システム上のアダプターに関する情報を提供する D3DKMT_ENUMADAPTERS2 構造体へのポインター。 「解説」を参照してください。

戻り値

D3DKMTEnumAdapters2 は、成功した場合、または次のいずれかのエラーが発生したときにSTATUS_SUCCESSを返します。

リターン コード 説明
STATUS_BUFFER_TOO_SMALL 指定された配列が小さすぎて、すべてのアダプターを受け取れなすぎます。
STATUS_INVALID_PARAMETER pAdapters が NULL であるか、それ以外の場合は無効なメモリ領域です。
STATUS_NO_MEMORY 操作を満たすためにメモリを割り当てることはできません。

注釈

入力時に、 NumAdapters は 、pAdapters が指す空の配列で返すことができるアダプターの数を指定します。 D3DKMT_ENUMADAPTERS2がSTATUS_SUCCESS を 返す場合は、 が返されます。

  • pAdapters が NULL 以外の場合、NumAdapters には pAdapters 配列で返されるアダプターの数が含まれます。
  • pAdapters が NULL の場合、NumAdapters にはサポートされている最大アダプター数が含まれます。

D3DKMT_ENUMADAPTERS2がエラーを返す場合、NumAdapters は未定義です。

D3DKMTEnumAdapters2 は通常、次の 2 回呼び出されます。

  • 最初の呼び出しでは、 pAdapters を NULL に設定します。 D3DKMTEnumAdapters2 は、サポートされている最大アダプター数を NumAdapters に書き込みます。

  • 2 番目の呼び出しでは、 NumAdapters を最初の呼び出しで返された値に設定し、 pAdapters を NumAdaptersD3DKMT_ENUMADAPTERS2 構造体の配列を指すように設定します。 D3DKMTEnumAdapters2 は配列を入力し、入力した配列構造体 (アダプター) の数を返します。

D3DKMTEnumAdapters2 の呼び出し元がアダプターの列挙を正常に受け取ったら、アダプター D3DKMT_HANDLEsの有効期間を管理するのは呼び出し元の責任です。 これらのハンドルは pAdapter を介して返され、 D3DKMTCloseAdapter で閉じる必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム Windows
ヘッダー d3dkmthk.h (D3dkmthk.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

こちらもご覧ください

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter