DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 구조체(d3dkmddi.h)

아티클
11/11/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

[in] 설명할 표준 할당의 형식을 식별하는 D3DKMDT_STANDARDALLOCATION_TYPE형식화된 값입니다.

pCreateSharedPrimarySurfaceData

[in] StandardAllocationType D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE 지정하는 경우 D3DKMDT_SHAREDPRIMARYSURFACEDATA 구조체에 대한 포인터입니다.

pCreateShadowSurfaceData

[in] standardAllocationType D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE 지정하는 경우 D3DKMDT_SHADOWSURFACEDATA 구조체에 대한 포인터입니다.

pCreateStagingSurfaceData

[in] StandardAllocationType D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE 지정하는 경우 D3DKMDT_STAGINGSURFACEDATA 구조체에 대한 포인터입니다.

pCreateGdiSurfaceData

[in] D3DKMDT_GDISURFACEDATA 구조체에 대한 포인터로, StandardAllocationType D3DKMDT_STANDARDALLOCATION_GDISURFACE 지정하는 경우에만 사용할 수 있습니다.

이 멤버는 Windows 7부터 사용할 수 있습니다.

pCreateVirtualGpuSurfaceData

StandardAllocationTypeD3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE경우 D3DKMDT_VIRTUALGPUSURFACEDATA 구조체에 대한 포인터입니다. WDDM 2.1부터 사용할 수 있습니다.

pCreateFenceStorageData

StandardAllocationTypeD3DKMDT_STANDARDALLOCATION_FENCESTORAGE경우 D3DKMDT_FENCESTORAGESURFACEDATA 구조체에 대한 포인터입니다. WDDM 3.2부터 사용할 수 있습니다.

pAllocationPrivateDriverData

[in/out] 표준 할당 유형을 설명하는 할당 프라이빗 데이터 블록에 대한 포인터입니다. 그렇지 않으면 이 멤버가 NULL입니다. 디스플레이 미니포트 드라이버(KMD)DxgkDdiGetStandardAllocationDriverData 함수가 반환하는 할당 프라이빗 데이터는 StandardAllocationType에서 드라이버가 요청하는 형식에 따라.

AllocationPrivateDriverDataSize

[out] pAllocationPrivateDriverData 가리키는 할당 개인 데이터의 크기(바이트)입니다. 드라이버가 pAllocationPrivateDriverData NULL로 설정하는 경우 드라이버는 AllocationPrivateDriverDataSize 드라이버가 지정된 표준 할당 유형을 설명하는 데 필요한 버퍼 크기로 설정해야 합니다.

드라이버가 표준 할당 유형에 대해 각 할당에 대해 프라이빗 데이터를 사용하지 않는 경우 드라이버는 AllocationPrivateDriverDataSize 0으로 설정할 수 있습니다.

pResourcePrivateDriverData

[in/out] 표준 할당 유형을 설명하는 리소스 프라이빗 데이터 블록에 대한 포인터입니다. 그렇지 않으면 이 멤버가 NULL입니다. 디스플레이 미니포트 드라이버의 DxgkDdiGetStandardAllocationDriverData 함수가 반환하는 리소스 개인 데이터는 StandardAllocationType에서 드라이버가 요청하는 형식에 따라.

ResourcePrivateDriverDataSize

[out] pResourcePrivateDriverData 가리키는 리소스 개인 데이터의 크기(바이트)입니다. 드라이버가 pResourcePrivateDriverData NULL로 설정하는 경우 드라이버는 ResourcePrivateDriverDataSize 드라이버가 지정된 표준 할당 유형을 설명하는 데 필요한 버퍼 크기로 설정해야 합니다.

드라이버가 표준 할당 유형에 대해 각 리소스에 대해 프라이빗 데이터를 사용하지 않는 경우 드라이버는 resourcePrivateDriverDataSize 설정할 수 있습니다.

PhysicalAdapterIndex

[in] 스토리지가 상주할 LDA 구성의 실제 어댑터 인덱스입니다.

발언

표준 할당 유형은 사용자 모드 표시 드라이버와 통신하지 않고 커널 모드로 만들어야 하는 할당입니다.

커널 모드 표시 미니포트 드라이버(KMD)가 pAllocationPrivateDriverData NULL을 반환하고 pResourcePrivateDriverData 멤버를 경우 AllocationPrivateDriverDataSize 및 ResourcePrivateDriverDataSize 멤버에 필요한 버퍼의 크기를 반환해야 합니다. 그러나 KMD는 버퍼의 필요한 크기를 얻기 위해 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 포함하는 공용 구조체의 표준 할당 구조체의 내용을 변경해서는 안 됩니다.

KMD는 ResourcePrivateDriverDataSize 또는 AllocationPrivateDriverDataSize 설정할 수 있지만 둘 다 0으로 설정할 수는 없습니다.