DirectDrawCreateEx 함수(ddraw.h)

DirectX 7.0에서 Direct3D 인터페이스 집합을 지원하는 DirectDraw 개체의 instance 만듭니다. DirectX 7.0에서 Direct3D의 기능을 사용하려면 이 함수를 사용하여 DirectDraw 개체를 만듭니다.

구문

HRESULT DirectDrawCreateEx(
  [in]  GUID     *lpGuid,
  [out] LPVOID   *lplpDD,
  [in]  REFIID   iid,
  [in]  IUnknown *pUnkOuter
);

[in] lpGuid

만들 드라이버를 나타내는 GUID(Globally Unique Identifier)에 대한 포인터입니다. 활성 디스플레이 드라이버를 나타내는 NULL이거나 다음 플래그 중 하나를 전달하여 디버깅을 위해 활성 디스플레이 드라이버의 동작을 제한할 수 있습니다.

DirectDraw 개체는 모든 기능에 에뮬레이션을 사용합니다. 하드웨어 지원 기능을 활용하지 않습니다.

DirectDraw 개체는 하드웨어에서 지원하지 않는 기능을 에뮬레이트하지 않습니다. 지원되지 않는 기능이 필요한 메서드를 호출하려고 시도하면 실패하고 DDERR_UNSUPPORTED 반환됩니다.

[out] lplpDD

호출이 성공하면 유효한 IDirectDraw7 인터페이스 포인터로 설정할 변수에 대한 포인터입니다.

[in] iid

이 매개 변수는 IID_IDirectDraw7 설정해야 합니다. 이 함수는 실패하고 다른 인터페이스가 지정된 경우 DDERR_INVALIDPARAMS 반환합니다.

[in] pUnkOuter

COM 집계 기능과의 향후 호환성을 허용합니다. 현재 이 매개 변수가 NULL이 아닌 경우 이 함수는 오류를 반환합니다.

함수가 성공하면 반환 값이 DD_OK.

실패하면 함수는 다음 오류 값 중 하나를 반환할 수 있습니다.

이 함수는 DirectDraw 개체를 초기화한 다음 호출이 성공하면 개체에 대한 포인터를 설정합니다.

여러 모니터가 있는 컴퓨터에서 lpGUID에 대해 NULL을 지정하는 경우 DirectDraw 개체는 일반 협력 수준이 설정되면 에뮬레이션 모드에서 실행됩니다. 이러한 컴퓨터에서 하드웨어 가속을 사용하려면 디바이스의 GUID를 지정합니다.

LoadLibrary를 사용하여 Ddraw.dll 명시적으로 연결한 다음 GetProcAddress를 사용하여 DirectDrawCreateEx 함수에 액세스해야 합니다.