PFND3DDDI_TEXBLT1 콜백 함수(d3dumddi.h)

  • 아티클

원본 텍스처의 모든 구슬을 포함하여 원본 텍스처에서 대상 텍스처로 비트 블록 전송(비트블렛) 작업을 수행합니다. WDDM(Windows Display Driver Model) 1.2 이상 사용자 모드 디스플레이 드라이버에 의해 구현됩니다.

구문

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

HRESULT Pfnd3dddiTexblt1(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}

매개 변수

hDevice

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

unnamedParam2

pData [in]

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

반환 값

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

설명

Microsoft Direct3D 런타임은 사용자 모드 표시 드라이버의 TexBlt 함수를 호출하여 드라이버에 원본 텍스처에서 대상 텍스처로 비트blt 작업을 수행하도록 알릴 수 있습니다. 텍스처는 입방 환경 맵일 수도 있습니다. 드라이버는 원본 텍스처의 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 8
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 데스크톱
머리글 d3dumddi.h(D3dumddi.h 포함)

추가 정보

샌드위치

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS