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 |