PDD_DESTROYDDLOCAL 콜백 함수(ddrawint.h)

아티클
02/26/2024

D3dDestroyDDLocal 함수는 동일한 지정된 로컬 Microsoft DirectDraw 개체에 속하는 D3dCreateSurfaceEx 함수에서 이전에 만든 모든 Microsoft Direct3D 표면을 삭제합니다.

구문

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

매개 변수

unnamedParam1

드라이버가 표면을 파괴하는 데 필요한 정보를 포함하는 DDHAL_DESTROYDDLOCALDATA 구조를 가리킵니다.

반환 값

D3dDestroyDDLocal 은 다음 콜백 코드 중 하나를 반환합니다.

설명

모든 Direct3D 드라이버는 D3dDestroyDDLocal을 지원해야 합니다.

Direct3D는 애플리케이션이 Direct3D 컨텍스트가 더 이상 필요하지 않으며 연결된 모든 표면과 함께 제거됨을 나타내면 D3dDestroyDDLocal 을 호출합니다. 연결은 로컬 DirectDraw 개체에 대한 포인터를 통해 제공됩니다. 필요한 경우 드라이버의 D3dCreateSurfaceEx 콜백이 각 표면에 할당된 메모리를 해제해야 합니다.

드라이버는 이러한 Direct3D 표면과 연결된 DirectDraw 표면을 파괴해서는 안 됩니다. 이는 애플리케이션의 책임입니다.

D3dContextCreate가 호출될 때 D3DHAL_CONTEXTCREATEDATA 구조체의 lpDDLcl 멤버로 전달된 DD_DIRECTDRAW_LOCAL 구조체에 대한 포인터는 D3dDestroyDDLocal이 반환된 후 운영 체제에서 해제됩니다.

사용하지 않도록 설정된 PDEV를 사용하여 D3dDestroyDDLocal을 호출할 수 있습니다. 디스플레이 드라이버의 DrvAssertMode 함수를 호출하여 PDEV를 사용하지 않도록 설정하거나 사용할 수 있습니다. 자세한 내용은 PDEV 관리를 참조하세요.