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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |