Microsoft DirectX 2

DDERR_SURFACELOST


lpDDSurface

Адрес DirectDrawSurface структуры  для дублирования.

lplpDupDDSurface

Адрес DirectDrawSurface указателя, который указывает на недавно созданную двойную структуру DirectDrawSurface.

Этот метод создает новый объект DirectDrawSurface, который указывает на ту же самую поверхностную память как существующий объект DirectDrawSurface. Этот дубликат может использоваться точно так же как первоначальный объект. Поверхностная память разрушается после того, как последний объект, ссылающийся на нее разрушен. Основная поверхность, поверхность 3D, или неявно созданная поверхность не может быть дублирована.


lpContext

Адрес caller-определенной структуры, которая передается члену перечисления каждый раз, когда этот метод  вызывается.

lpEnumSurfacesCallback

Адрес функции EnumSurfacesCallback, которую будет запрашивать каждая поверхность которая присоединена к этой поверхности.




Этот метод может использоваться, чтобы перераспределить поверхностную память. Когда объект DirectDrawSurface теряет поверхностную память, большинство методов возвратит DDERR_SURFACELOST и не выполнит никакую другую функцию.

Поверхности могут терять память, когда изменен режим платы дисплея, или потому что прикладная программа получила исключительный доступ к плате дисплея и освободила всю поверхностную память, в настоящее время распределенную на плате дисплея.




dwFlags

Этот параметр не используется в это время и должен быть установлен в 0.

Этот метод работает только на поверхностях системной памяти;  не будет блокироваться страница поверхности памяти дисплея или эмулированной основной поверхности. Если этот метод обратился к поверхности памяти дисплея,он не будет делать ничего за исключением возвращения DD_OK.

Чтобы гарантировать согласие с  COM, этот метод - не,  часть интерфейса IDirectDrawSurface, но принадлежит интерфейсу IDirectDrawSurface2. Чтобы использовать этот метод, Вы должны сначала сделать запрос для интерфейса IDirectDrawSurface2. Для большего количества информации, см. Интерфейс IDirectDrawSurface2.



Содержание раздела