Метод IDirect3DDevice9::GetTexture (d3d9.h)
Извлекает текстуру, назначенную сцене для устройства.
Синтаксис
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 приводит к утечке памяти.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d3d9.h (включая D3D9.h) |
| Библиотека | D3D9.lib |