D3DDDIARG_COMPOSERECTS 구조체(d3dumddi.h)

  • 아티클

D3DDDIARG_COMPOSERECTS 구조체는 사각형 영역을 구성하는 데 사용되는 매개 변수를 설명합니다.

구문

typedef struct _D3DDDIARG_COMPOSERECTS {
  [in] HANDLE                hSrcResource;
  [in] UINT                  SrcSubResourceIndex;
  [in] HANDLE                hDstResource;
  [in] UINT                  DstSubResourceIndex;
  [in] HANDLE                hSrcRectDescsVB;
  [in] UINT                  NumRects;
  [in] HANDLE                hDstRectDescsVB;
  [in] D3DDDI_COMPOSERECTSOP Operation;
  [in] INT                   XOffset;
  [in] INT                   YOffset;
} D3DDDIARG_COMPOSERECTS;

멤버

[in] hSrcResource

원본 표면을 포함하는 원본 리소스에 대한 핸들입니다. 표면이 만들어지면 사용자 모드 표시 드라이버는 드라이버의 CreateResource 함수 호출에서 D3DDDIARG_CREATERESOURCE 구조체의 Flags 멤버에 있는 Format 멤버 및 TextApi 비트 필드 플래그의 D3DDDIFMT_A1(픽셀당 1비트) 값을 받습니다. 표면은 텍스처의 일부로 만들어야 합니다.

[in] SrcSubResourceIndex

원본 리소스 내의 원본 표면에 대한 인덱스입니다.

[in] hDstResource

대상 표면을 포함하는 대상 리소스에 대한 핸들입니다. 표면이 만들어지면 사용자 모드 표시 드라이버는 드라이버의 CreateResource 호출에서 D3DDDIARG_CREATERESOURCE Format 멤버의 D3DDDIFMT_A1(픽셀당 1비트) 값을 받습니다. 표면은 텍스처의 일부로 만들어야 합니다. TextApi 비트 필드 플래그를 사용하여 표면을 만들었을 수 있습니다.

[in] DstSubResourceIndex

대상 리소스 내의 대상 화면에 대한 인덱스입니다.

[in] hSrcRectDescsVB

D3DCOMPOSERECTSRCDESC 구조의 배열을 포함하는 꼭짓점 버퍼에 대한 핸들입니다. 배열의 각 요소는 원본 표면의 사각형을 정의합니다. 꼭짓점 버퍼가 만들어지면 사용자 모드 표시 드라이버는 드라이버의 CreateResource 함수 호출에서 D3DDDIARG_CREATERESOURCE 구조체의 Flags 멤버에서 TextApi 비트 필드 플래그를 받습니다.

[in] NumRects

복사할 사각형 영역의 수입니다. 이는 hDstRectDescsVB 멤버로 식별되는 꼭짓점 버퍼의 D3DCOMPOSERECTDSTDESC 구조체 수입니다. 드라이버는 NumRects 가 0xFFFF 이상으로 설정된 ComposeRects 에 대한 호출을 무시해야 합니다.

[in] hDstRectDescsVB

D3DCOMPOSERECTDSTDESC 구조의 배열을 포함하는 꼭짓점 버퍼에 대한 핸들입니다. 배열의 각 요소는 대상 화면에서 원본 사각형을 복사할 위치를 정의합니다. 자세한 내용은 아래 설명 부분을 참조하십시오. 꼭짓점 버퍼가 만들어지면 사용자 모드 표시 드라이버는 드라이버의 CreateResource 함수 호출에서 D3DDDIARG_CREATERESOURCE 구조체의 Flags 멤버에서 TextApi 비트 필드 플래그를 받습니다.

[in] Operation

사각형 영역을 구성하는 방법을 설명하는 D3DDDI_COMPOSERECTSOP 값입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
D3DDDICOMPOSERECTS_COPY 각 원본 비트를 대상으로 복사합니다.
D3DDDICOMPOSERECTS_OR OR 작업에서 원본 및 대상 비트를 결합하고 대상에 복사합니다.
D3DDDICOMPOSERECTS_AND AND 작업에서 원본 및 대상 비트를 결합하고 대상에 복사합니다.
D3DDDICOMPOSERECTS_NEG 원본 비트의 음수와 대상 비트를 결합하고 대상에 복사합니다. [Dest bit &(~ Src 비트)]

[in] XOffset

모든 대상 사각형 영역의 x 좌표에 추가할 오프셋입니다. 오프셋은 음수일 수 있으므로 결과 사각형이 거부되거나 잘리게 될 수 있습니다.

[in] YOffset

모든 대상 사각형 영역의 y 좌표에 추가할 오프셋입니다. 오프셋은 음수일 수 있으므로 결과 사각형이 거부되거나 잘리게 될 수 있습니다.

설명

작성 지침이 포함된 꼭짓점 버퍼는 D3DUSAGE_TEXTAPI 사용으로 만들어집니다. 다음 코드는 꼭짓점 버퍼 배열에 포함된 구조를 정의합니다. 이러한 구조에 대한 자세한 내용은 DirectX SDK 설명서를 참조하세요.

struct D3DCOMPOSERECTSRCDESC {
USHORT X, Y;          // Coordinates of top-left corner
USHORT width, height; // Width and height of the glyph in bits
};

struct D3DCOMPOSERECTDSTDESC {
USHORT RectDescIndex; // Index of one of the D3DCOMPOSERECTSRCDESC structures in the vertex buffer represented by hSrcRectDescsVB
USHORT reserved;      // Use to align the struct and fields to good boundaries
SHORT X, Y;            // Position in bits in the destination surface
};

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글 d3dumddi.h(D3dumddi.h 포함)

추가 정보

ComposeRects

RECT