Метод IDirect3DDevice9::GetTexture (d3d9helper.h)

Статья
08/23/2023

Извлекает текстуру, назначенную сцене для устройства.

Синтаксис

HRESULT GetTexture(
  [in]          DWORD                 Stage,
  [out, retval] IDirect3DBaseTexture9 **ppTexture
);

Параметры

[in] Stage

Тип: DWORD

Идентификатор этапа извлекаемой текстуры. Идентификаторы этапов отсчитываются от нуля.

[out, retval] ppTexture

Тип: IDirect3DBaseTexture9**

Адрес указателя на интерфейс IDirect3DBaseTexture9 , представляющий возвращаемую текстуру.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL.

Как правило, методы, возвращающие состояние, не работают на устройстве, созданном с помощью D3DCREATE_PUREDEVICE. Однако этот метод будет работать даже на чистом устройстве, так как он возвращает интерфейс.

Вызов этого метода увеличит количество внутренних ссылок в интерфейсе IDirect3DTexture9 . Сбой вызова IUnknown::Release после завершения использования этого интерфейса IDirect3DTexture9 приводит к утечке памяти.