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

추가 정보

IDirectDrawSurface7