次の方法で共有

D3DDDICB_QUERYRESIDENCY構造体 (d3dumddi.h)

  • [アーティクル]

D3DDDICB_QUERYRESIDENCY構造体は、リソースまたは割り当ての一覧の常駐状態を記述します。

構文

typedef struct _D3DDDICB_QUERYRESIDENCY {
  [in]  HANDLE                 hResource;
  [in]  UINT                   NumAllocations;
  [in]  const D3DKMT_HANDLE    *HandleList;
  [out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;

メンバーズ

[in] hResource

常駐が照会されるリソースへのハンドル。 ユーザー モード ディスプレイ ドライバーは、常駐を照会するために、HandleList メンバーの配列を使用する場合、hResource NULL をに設定します。

hResource が null 場合、リソースに属するすべての割り当てが照会され、pResidencyStatus が指す配列の最初の要素 結果が返されます。 リソースの常駐状態は、リソースに属するすべての割り当ての最も低い常駐状態と等しくなります。

[in] NumAllocations

HandleList 配列内の割り当ての数。 ユーザー モード ディスプレイ ドライバーは、hResource メンバー内のハンドルを非NULLに設定する場合は、numAllocations 0 に設定する必要があります。

[in] HandleList

割り当てに対するカーネル モード ハンドルを表すD3DKMT_HANDLEデータ型の配列。 Microsoft Direct3D ランタイムの pfnAllocateCb 関数は、これらのハンドルを返します。 したがって、ユーザー モードのディスプレイ ドライバーは、これらのハンドルを使用して常駐を照会します。

ユーザー モード ディスプレイ ドライバーは、hResource メンバーのハンドルを非NULLに設定する場合は、HandleList NULL をに設定する必要があります。

[out] pResidencyStatus

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

値の 意味
D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) リソースまたは割り当ての一覧は GPU メモリ内に存在します。これは、常駐状態が最も高くなります。
D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) リソースまたは割り当ての一覧は、共有メモリ内に存在します。
D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) 割り当てのリソースまたは一覧は、最も低い常駐状態である非居住者です。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
ヘッダー d3dumddi.h (D3dumddi.h を含む)

関連項目

pfnQueryResidencyCb の