Share via

IDirect3DStateBlock9::Capture-Methode (d3d9helper.h)

  • Artikel

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 Zustandsblocks und das Aufrufen der Capture-Methode bringt 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

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9helper.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DStateBlock9