DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA構造体 (d3dkmddi.h)

[アーティクル]
05/23/2024

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA構造体は、標準の割り当ての種類を表します。

構文

typedef struct _DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA {
  D3DKMDT_STANDARDALLOCATION_TYPE StandardAllocationType;
  union {
    D3DKMDT_SHAREDPRIMARYSURFACEDATA *pCreateSharedPrimarySurfaceData;
    D3DKMDT_SHADOWSURFACEDATA        *pCreateShadowSurfaceData;
    D3DKMDT_STAGINGSURFACEDATA       *pCreateStagingSurfaceData;
    D3DKMDT_GDISURFACEDATA           *pCreateGdiSurfaceData;
    D3DKMDT_VIRTUALGPUSURFACEDATA    *pCreateVirtualGpuSurfaceData;
    D3DKMDT_FENCESTORAGESURFACEDATA  *pCreateFenceStorageData;
  };
  VOID                            *pAllocationPrivateDriverData;
  UINT                            AllocationPrivateDriverDataSize;
  VOID                            *pResourcePrivateDriverData;
  UINT                            ResourcePrivateDriverDataSize;
  UINT                            PhysicalAdapterIndex;
} DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA;

メンバー

StandardAllocationType

[入力] 記述する標準割り当ての種類を識別する、D3DKMDT_STANDARDALLOCATION_TYPE型指定された値。

pCreateSharedPrimarySurfaceData

[入力]StandardAllocationType でD3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACEが指定されている場合は、D3DKMDT_SHAREDPRIMARYSURFACEDATA構造体へのポインター。

pCreateShadowSurfaceData

[入力]StandardAllocationType でD3DKMDT_STANDARDALLOCATION_SHADOWSURFACEが指定されている場合は、D3DKMDT_SHADOWSURFACEDATA構造体へのポインター。

pCreateStagingSurfaceData

[入力]StandardAllocationType でD3DKMDT_STANDARDALLOCATION_STAGINGSURFACEが指定されている場合は、D3DKMDT_STAGINGSURFACEDATA構造体へのポインター。

pCreateGdiSurfaceData

[入力] D3DKMDT_GDISURFACEDATA 構造体へのポインター。 StandardAllocationType でD3DKMDT_STANDARDALLOCATION_GDISURFACEが指定されている場合にのみ使用できます。

このメンバーは、Windows 7 以降で使用できます。

pCreateVirtualGpuSurfaceData

StandardAllocationType がD3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACEされている場合は、D3DKMDT_VIRTUALGPUSURFACEDATA構造体へのポインター。 WDDM 2.1 以降で使用できます。

pCreateFenceStorageData

pAllocationPrivateDriverData

[入力/出力]標準の割り当ての種類を記述する割り当てプライベートデータのブロックへのポインター。それ以外の場合、このメンバーは NULL です。ディスプレイミニポートドライバーの DxgkDdiGetStandardAllocationDriverData 関数が返す割り当てプライベートデータは、ドライバーが StandardAllocationType で要求する種類によって異なります。

AllocationPrivateDriverDataSize

[out] pAllocationPrivateDriverData が指す割り当てプライベートデータのサイズ (バイト単位)。ドライバーが pAllocationPrivateDriverData を NULL に設定する場合、ドライバーは AllocationPrivateDriverDataSize を、ドライバーが指定された標準割り当ての種類を記述するために必要なバッファーのサイズに設定する必要があります。

ドライバーが標準割り当ての種類の割り当てごとにプライベートデータを使用しない場合、ドライバーは AllocationPrivateDriverDataSize を 0 に設定できます。

pResourcePrivateDriverData

[入力/出力]標準割り当ての種類を記述するリソースプライベートデータのブロックへのポインター。それ以外の場合、このメンバーは NULL です。ディスプレイミニポートドライバーの DxgkDdiGetStandardAllocationDriverData 関数が返すリソースプライベートデータは、ドライバーが StandardAllocationType で要求する種類によって異なります。

ResourcePrivateDriverDataSize

[out] pResourcePrivateDriverData が指すリソースプライベートデータのサイズ (バイト単位)。ドライバーが pResourcePrivateDriverData を NULL に設定する場合、ドライバーは ResourcePrivateDriverDataSize を、ドライバーが指定された標準割り当ての種類を記述するために必要なバッファーのサイズに設定する必要があります。

ドライバーが標準の割り当ての種類のリソースごとにプライベートデータを使用しない場合、ドライバーは ResourcePrivateDriverDataSize を 0 に設定できます。

PhysicalAdapterIndex

注釈

ディスプレイミニポートドライバーが pAllocationPrivateDriverData メンバーと pResourcePrivateDriverData メンバーで NULL を返す場合、ドライバーは AllocationPrivateDriverDataSize および ResourcePrivateDriverDataSize メンバーでドライバーが必要とするバッファーのサイズを返す必要があります。ただし、ドライバーは、バッファーの必要なサイズを取得するために、DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA含まれる共用体の標準割り当て構造の内容を変更しないでください。

ドライバーは ResourcePrivateDriverDataSize または AllocationPrivateDriverDataSize を 0 に設定できますが、ドライバーは両方を 0 に設定できません。