D3DDDIARG_CREATERESOURCE2 구조체(d3dukmdt.h)

아티클
02/23/2024

리소스를 만들기 위한 정보를 포함합니다. WDDM(Windows Display Driver Model) 1.2 이상 사용자 모드 디스플레이 드라이버에서 사용됩니다.

구문

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

멤버

[in] Format

리소스의 형식을 나타내는 D3DDDIFORMAT 형식의 값입니다.

[in] Pool

리소스가 생성되는 메모리 풀의 형식을 나타내는 형식 D3DDDI_POOL 값입니다.

[in] MultisampleType

다중 샘플링된 표면의 샘플 수를 나타내는 형식 D3DDDIMULTISAMPLE_TYPE 값입니다. 표면이 여러 샘플링되지 않은 경우 이 값은 D3DDDIMULTISAMPLE_NONE(0)입니다.

[in] MultisampleQuality

다중 샘플링된 표면에서 렌더링 샘플의 품질 수준입니다. 품질 수준은 각각 1에서 8까지의 품질 수준을 나타내는 0에서 7까지의 숫자여야 합니다.

표면이 다중 샘플링되지 않더라도(즉, multisampleType에서 D3DDDIMULTISAMPLE_NONE 지정한 경우) 여전히 1보다 큰 품질 수준을 가질 수 있습니다(0보다 큰 숫자를 사용하여 지정됨).

[in] pSurfList

만들 표면(또는 기타 리소스 종류) 목록에 대한 D3DDDI_SURFACEINFO 구조체의 배열입니다.

[in] SurfCount

pSurfList 멤버가 지정한 배열의 리소스 수입니다.

[in] MipLevels

리소스에 대한 MIP 맵 수준 수입니다.

[in] Fvf

꼭짓점 버퍼에 대한 FVF 형식입니다.

[in] VidPnSourceId

기본 표면이 생성되는 VidPN(비디오 현재 네트워크) 토폴로지의 경로에 있는 비디오 원본의 0부터 시작하는 식별 번호입니다(리소스에 기본 표면이 포함된 경우).

[in] RefreshRate

리소스가 사용되는 새로 고침 빈도를 지정하는 D3DDDI_RATIONAL 구조체입니다. 이 멤버는 리소스가 기본 표면이고 MatchGdiPrimary 비트 필드 플래그가 Flags 멤버에 설정되지 않은 경우에만 적용됩니다. 또한 InterlacedRefresh 비트 필드 플래그가 Flags에 설정된 경우 사용자 모드 표시 드라이버는 새로 고침 빈도가 인터리브됨(그렇지 않으면 점진적)으로 결정합니다.

[in/out] hResource

리소스에 대한 핸들입니다. CreateResource2 함수에 대한 입력 시 hResource는 드라이버가 Microsoft Direct3D 런타임으로 다시 호출할 때마다 사용해야 하는 핸들을 지정합니다.

드라이버는 고유한 핸들을 생성하고 Direct3D 런타임에 다시 전달합니다. CreateResource2 함수의 출력에서 hResource는 Direct3D 런타임이 리소스를 식별하기 위해 후속 드라이버 호출에 사용해야 하는 핸들을 지정합니다.

[in] Flags

만들 리소스의 유형을 식별하는 D3DDDI_RESOURCEFLAGS 구조체입니다. D3DDDI_RESOURCEFLAGS 비트 필드 플래그 중 일부는 추가 비트 필드 플래그도 설정해야 합니다.

[in] Rotation

리소스의 방향을 식별하는 D3DDDI_ROTATION 형식의 값입니다.

예를 들어 사용자 모드 디스플레이 드라이버는 480x640 표면을 90도(D3DDDI_ROTATION_90) 회전하라는 요청을 수신하는 것이 좋습니다. 드라이버는 스캔을 위해 640x480 모드로 표면을 할당해야 합니다. 표면으로 렌더링할 때 드라이버는 90도 회전을 수행해야 합니다.

D3DDDI_ROTATION_IDENTITY 이외의 방향은 기본 비트 필드 플래그가 Flags 멤버에도 설정된 경우에만 설정됩니다.

[in] Flags2

만들 리소스의 형식을 식별하는 D3DDDI_RESOURCEFLAGS2 구조체입니다. D3DDDI_RESOURCEFLAGS2 비트 필드 플래그 중 일부는 추가 비트 필드 플래그도 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
머리글	d3dukmdt.h(D3dukmdt.h, D3dkmddi.h 포함)