D3DKMTEnumAdapters3 関数 (d3dkmthk.h)

  • [アーティクル]

システム上のグラフィックス アダプターとディスプレイ アダプターを列挙するための情報を提供します。

構文

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

パラメーター

[in/out] unnamedParam1

D3DKMT_ENUMADAPTERS3構造体。 呼び出し元は、配列サイズと空の配列スペースを渡します。 呼び出し先は、配列に十分なスペースがあることを確認し、配列を入力し、使用された配列の量を返します。

戻り値

この関数は NTSTATUS を返します。

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

注釈

D3DKMT_ENUMADAPTERS3::p Adapters が null の場合、D3DKMT_ENUMADAPTERS3::NumAdapters はサポートされるアダプターの最大数に設定されます。 呼び出し先は、通常、サポートされているアダプターの最大数を取得するために、最初に メソッドを呼び出します。

呼び出し先がアダプターを正常に列挙すると、アダプター D3DKMT_HANDLEsの有効期間を明示的に管理する役割が担います。 これらのハンドルは pEnumAdapters を介して呼び出し先に返され、 D3DKMTCloseAdapter で閉じる必要があります。

D3DKMT_ENUMADAPTERS3::Filter フラグを設定しない場合でも、アダプターは列挙されますが、 D3DKMTEnumAdapters2 の列挙よりもアダプターの数は少なくなります。 ComputeOnly アダプターは、アプリケーションの中断を回避するために、既定の列挙体から除外されます。 DisplayOnly アダプターも既定の列挙体から除外されます。

要件

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

こちらもご覧ください

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

PFND3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter