DXGKARG_OPENALLOCATION 構造体 (d3dkmddi.h)

[アーティクル]
08/07/2023

DXGKARG_OPENALLOCATION構造体は、ディスプレイミニポートドライバーを開く必要がある割り当てを記述します。

構文

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

メンバー

[in] NumAllocations

pOpenAllocation メンバーが指定する配列内の要素の数。これは、開くデバイス固有の割り当ての数を表します。

[in/out] pOpenAllocation

割り当てを開く DXGK_OPENALLOCATIONINFO 構造体の配列。

[in] pPrivateDriverData

ユーザーモードのディスプレイドライバーからディスプレイミニポートドライバーに渡されるプライベートデータのブロックへのポインター。プライベートデータのこのブロックは、DxgkDdiCreateAllocation 関数の呼び出しで、DXGKARG_CREATEALLOCATION構造体の pPrivateDriverData メンバーに渡されるのと同じリソース固有のデータです。ディスプレイミニポートドライバーは、プライベートデータのこのブロックを変更できません。

[in] PrivateDriverSize

pPrivateDriverData が指すプライベートデータのブロックのサイズ (バイト単位)。

[in] Flags

割り当てに対して実行する操作を識別する DXGK_OPENALLOCATIONFLAGS 構造体。

[in] SubresourceIndex

Windows 8 以降でサポートされています。

レンダーターゲットサーフェスのリソースへのインデックス。

オペレーティングシステムでは、ディスプレイミニポートドライバーが GDI ハードウェアアクセラレータをサポートしている場合にのみ、このメンバーを指定します。具体的には、ディスプレイミニポートドライバーは、DxgkDdiRenderKm 関数を実装する必要があり、 DXGKARG_CREATEDEVICEで設定されている GdiDevice メンバーを持つデバイスを作成する必要があります。フラグ。

SubresourceIndex の値が割り当て内のサブリソースの数を超える場合、ディスプレイミニポートドライバーはエラーを返す必要があります。

[out] SubresourceOffset

Windows 8 以降でサポートされています。

割り当ての開始からサブリソースの開始までのオフセット (バイト単位)。

[out] Pitch

Windows 8 以降でサポートされています。

割り当てのピッチ (バイト単位)、つまり次の行の先頭までの距離 (バイト単位)。