次の方法で共有

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 最初の呼び出しで返された値に設定し、NumAdaptersD3DKMT_ENUMADAPTERS2 構造体の配列を指すように pAdapters 設定します。 D3DKMTEnumAdapters2 は配列を入力し、その配列構造体 (アダプター) の数を返します。

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

必要条件

要件 価値
サポートされる最小クライアント Windows 8
サポートされる最小サーバー Windows Server 2012
ターゲット プラットフォーム の ウィンドウズ
ヘッダー d3dkmthk.h (D3dkmthk.h を含む)
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter