次の方法で共有

D3DKMT_QUERYALLOCATIONRESIDENCY構造体 (d3dkmthk.h)

  • [アーティクル]

D3DKMT_QUERYALLOCATIONRESIDENCY構造体は、リソースまたは割り当ての一覧から常駐状態を取得するための情報を記述します。

構文

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE                    hDevice;
  [in]  D3DKMT_HANDLE                    hResource;
  [in]  const D3DKMT_HANDLE              *phAllocationList;
  [in]  UINT                             AllocationCount;
  [out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} D3DKMT_QUERYALLOCATIONRESIDENCY;

メンバーズ

[in] hDevice

リソースまたは割り当ての一覧が関連付けられているデバイスへのカーネル モード ハンドルを表すD3DKMT_HANDLEデータ型。

[in] hResource

常駐が照会されるリソースへのハンドル。 OpenGL ICD は、常駐のクエリを実行するために指定 phAllocationList 配列を使用する場合、hResource NULLを に設定します。 OpenGL ICD hResource を非NULL 値に設定する場合は、AllocationCount メンバーを 0 に設定し、phAllocationList を nullする必要があります。

hResource が NULLでない場合は、リソースに属するすべての割り当てが照会され、pResidencyStatus が指す配列の最初の要素 結果が返されます。

リソースに属する割り当てが常駐していない場合、リソース全体が常駐していないと見なされます。

リソースに属する各割り当てに関する詳細な常駐情報を取得するには、割り当てを照会する必要があります。

[in] phAllocationList

割り当てに対するカーネル モード ハンドルを表すD3DKMT_HANDLEデータ型の配列。 OpenGL ICD では、これらのハンドルを使用して所在地の状態を照会します。

OpenGL ICD は、hResource メンバーのハンドルを非NULL 値に設定する場合、phAllocationList NULLを する必要があります。

[in] AllocationCount

phAllocationList が指定 配列内の割り当ての数。 OpenGL ICD が、hResource メンバーのハンドルを非NULL 値に設定する場合は、AllocationCount 0 に設定する必要があります。

[out] pResidencyStatus

D3DKMT_ALLOCATIONRESIDENCYSTATUS列挙子の配列へのポインター。 hResource メンバーが NULL以外の場合、配列には 1 つの要素が含まれており、リソースの常駐状態を示すために次の表に示す列挙子のいずれかを受け取ります。 hResource NULL場合、配列内の要素の数は AllocationCount メンバーによって指定され、各要素は次のいずれかの列挙子を受け取り、phAllocationList 配列内の対応する割り当ての常駐状態を示します。

列挙 子 意味
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) リソースまたは割り当ては GPU メモリに存在します。
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) リソースまたは割り当ては共有メモリ内に存在します。
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) リソースまたは割り当てが非存在です。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
ヘッダー d3dkmthk.h (D3dkmthk.h を含む)

関連項目

D3DKMTQueryAllocationResidency