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 포함) |