PFND3DKMT_ENUMADAPTERS3 コールバック関数 (d3dkmthk.h)

[アーティクル]
02/26/2024

PFND3DKMT_ENUMADAPTERS3 コールバック関数は、システム上のグラフィックスアダプターとディスプレイアダプターを列挙します。

構文

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [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 フラグをいずれも設定しない場合でも、アダプターは列挙されますが、列挙 PFND3DKMT_ENUMADAPTERS2 よりもアダプターの数は少なくなります。 ComputeOnly アダプターは、アプリケーションの破損を回避するために、既定の列挙体から除外されます。 DisplayOnly アダプターも既定の列挙体から除外されます。