IDirect3DStateBlock9::Capture-Methode (d3d9.h)

Erfassen Sie den aktuellen Wert der Zustände, die in einem Stateblock enthalten sind.

Syntax

HRESULT Capture();

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, weil die Erfassung im Datensatzmodus nicht durchgeführt werden kann, wird der Rückgabewert D3DERR_INVALIDCALL.

Hinweise

Die Capture-Methode erfasst aktuelle Werte für Zustände in einem vorhandenen Zustandsblock. Es erfasst nicht den gesamten Zustand des Geräts. Beispiel:

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();

Das Erstellen eines leeren Stateblocks und das Aufrufen der Capture-Methode bewirkt nichts, wenn keine Zustände festgelegt wurden.

Die Capture-Methode erfasst keine Informationen für Lichter, die explizit oder implizit erstellt werden, nachdem der Stateblock erstellt wurde.

Anforderungen

Weitere Informationen

IDirect3DStateBlock9