다음을 통해 공유

PFND3DDDI_TEXBLT 콜백 함수(d3dumddi.h)

  • 아티클

TexBlt 함수는 원본 텍스처의 모든 구슬을 포함하여 원본 텍스처에서 대상 텍스처로 비트 블록 전송(비트블렛) 작업을 수행합니다.

구문

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

HRESULT Pfnd3dddiTexblt(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}

매개 변수

hDevice

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.

unnamedParam2

pData [in]

텍스처 비트blt 작업에 대한 매개 변수를 정의하는 D3DDDIARG_TEXBLT 구조체에 대한 포인터입니다.

반환 값

TexBlt는 텍스처 비트blt 작업이 성공적으로 수행되지 않은 경우 S_OK 또는 적절한 오류 결과를 반환합니다.

설명

Microsoft Direct3D 런타임은 사용자 모드 디스플레이 드라이버의 TexBlt 함수를 호출하여 드라이버에 원본 텍스처에서 대상 텍스처로 비트블렛 작업을 수행하도록 알릴 수 있습니다. 텍스처는 입방형 환경 맵일 수도 있습니다. 드라이버는 원본 텍스처에서 D3DDDIARG_TEXBLT 구조체의 SrcRect 멤버가 지정한 사각형을 대상 텍스처의 D3DDDIARG_TEXBLTDstPoint 멤버가 지정한 위치로 복사해야 합니다. 대상 및 원본 텍스처는 각각 D3DDDIARG_TEXBLT hDstResource 및 hSrcResource 핸들로 식별됩니다.

MIP 매핑된 텍스처의 경우 드라이버는 원본 텍스처에 있는 모든 MIP 맵 하위 수준도 복사해야 합니다. 원본 및 대상 텍스처에는 다양한 수의 MIP 맵 수준이 포함될 수 있습니다. 이 경우 드라이버는 공통 수준을 복사해야 합니다. 예를 들어 256x256 원본 텍스처에 8개의 MIP 맵 수준이 있고 대상이 6개 수준의 64x64 텍스처인 경우 드라이버는 원본에서 해당 수준 6개를 복사해야 합니다. 대상 텍스처의 최상위 MIP 수준 차원은 항상 원본 텍스처의 최상위 MIP 수준 차원보다 작거나 같습니다.

원본 및 대상 핸들은 항상 최상위 표면을 참조하며 MIP 맵 하위 수준도 참조하지 않습니다.

MIP 맵 텍스처의 임의 수준을 복사하기 위해 런타임은 드라이버의 Blt 함수를 대신 호출합니다.

원본 및 대상 텍스처의 픽셀 형식은 동일하며 일반적으로 지정된 비트blt 작업을 안전하게 수행할 수 있습니다.

요구 사항

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

추가 정보

샌드위치

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS