IDirectDrawSurface7::BltFast 메서드(ddraw.h)
원본 색 키 또는 대상 색 키를 사용하여 소스 복사 비트blt 또는 투명한 비트블렛을 수행합니다.
구문
HRESULT BltFast(
[in] DWORD unnamedParam1,
[in] DWORD unnamedParam2,
[in] LPDIRECTDRAWSURFACE7 unnamedParam3,
[in] LPRECT unnamedParam4,
[in] DWORD unnamedParam5
);
매개 변수
[in] unnamedParam1
대상 화면에서 비트blt할 x 좌표입니다.
[in] unnamedParam2
대상 화면에서 비트blt할 y 좌표입니다.
[in] unnamedParam3
bitblt의 원본인 DirectDrawSurface 개체의 IDirectDrawSurface7 인터페이스에 대한 포인터입니다.
[in] unnamedParam4
원본 표면에서 비트블렛할 사각형의 왼쪽 위와 오른쪽 아래 점을 정의하는 RECT 구조체에 대한 포인터입니다.
[in] unnamedParam5
전송 유형입니다. 다음 전송이 정의됩니다.
DDBLTFAST_DESTCOLORKEY
대상 색 키를 사용하는 투명한 비트blt입니다.
DDBLTFAST_NOCOLORKEY
투명도가 없는 일반 복사 비트blt입니다.
DDBLTFAST_SRCCOLORKEY
원본 색 키를 사용하는 투명한 비트blt입니다.
DDBLTFAST_WAIT
bitbltter가 사용 중인 경우 DDERR_WASSTILLDRAWING 메시지를 연기하고 비트블렛을 설정할 수 있거나 다른 오류가 발생하는 즉시 를 반환합니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_EXCEPTION
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDRECT
- DDERR_NOBLTHW
- DDERR_SURFACEBUSY
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
설명
BltFast 는 하드웨어에서 지원되는 경우 항상 비동기 블릿을 시도합니다.
BltFast 는 디스플레이 메모리 화면에서만 작동하며 비트blt 작업을 수행할 때는 클립할 수 없습니다. 연결된 클리퍼가 있는 표면에서 이 메서드를 사용하면 호출이 실패하고 메서드가 DDERR_UNSUPPORTED 반환합니다.
IDirectDrawSurface7::BltFast의 소프트웨어 구현은 IDirectDrawSurface7::Blt 메서드보다 10% 더 빠릅니다. 그러나 디스플레이 하드웨어를 사용하는 경우 둘 사이에 속도 차이가 없습니다.
일반적으로 IDirectDrawSurface7::BltFast 는 bitbltter가 사용 중이고 비트블렛을 설정할 수 없는 경우 오류와 함께 즉시 반환합니다. 그러나 비트blt를 설정할 수 있거나 다른 오류가 발생할 때까지 이 메서드가 반환되지 않도록 하려면 DDBLTFAST_WAIT 플래그를 사용할 수 있습니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | ddraw.h |
라이브러리 | Ddraw.lib |
DLL | Ddraw.dll |