Метод IDirect3DStateBlock9::Capture (d3d9.h)
Запишите текущее значение состояний, включенных в блок состояний.
Синтаксис
HRESULT Capture();
Возвращаемое значение
Тип: HRESULT
Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, так как запись не может быть выполнена в режиме записи, возвращаемое значение будет D3DERR_INVALIDCALL.
Комментарии
Метод Capture фиксирует текущие значения состояний в существующем блоке состояний. Он не фиксирует все состояние устройства. Пример:
IDirect3DStateBlock9* pStateBlock = NULL;
pd3dDevice->BeginStateBlock();
// Add the ZENABLE state to the stateblock
pd3dDevice->SetRenderState ( D3DRS_ZENABLE, D3DZB_TRUE );
pd3dDevice->EndStateBlock ( &pStateBlock );
// Change the current value that is stored in the state block
pd3dDevice->SetRenderState ( D3DRS_ZENABLE, D3DZB_FALSE );
pStateBlock->Capture();
pStateBlock->Release();
Создание пустого блокировщика состояния и вызов метода Capture не выполняет никаких действий, если состояния не заданы.
Метод Capture не будет захватывать сведения о индикаторах, которые явно или неявно создаются после создания stateblock.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d3d9.h (включая D3D9.h) |
| Библиотека | D3D9.lib |