ID3DXConstantTable::GetConstantDesc-Methode

Ruft einen Zeiger auf ein Array von Konstantenbeschreibungen in der Konstantentabelle ab.

Syntax

HRESULT GetConstantDesc(
  [in]      D3DXHANDLE        hConstant,
  [in, out] D3DXCONSTANT_DESC *pDesc,
  [in, out] UINT              *pCount
);

Parameter

hConstant [in]

Typ: D3DXHANDLE

Eindeutiger Bezeichner für eine Konstante. Siehe D3DXHANDLE.

pDesc [in, out]

Typ: D3DXCONSTANT_DESC*

Gibt einen Zeiger auf ein Array von Beschreibungen zurück. Siehe D3DXCONSTANT_DESC.

pCount [in, out]

Typ: UINT*

Die angegebene Eingabe muss die maximale Größe des Arrays aufweisen. Die Ausgabe ist die Anzahl der Elemente, die im Array ausgefüllt werden, wenn die Funktion zurückgegeben wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Bemerkungen

ID3DXConstantTable::GetConstantDesc gibt manchmal eine D3DXCONSTANT_DESC mit dem Register_Count 0 zurück. Dies geschieht, wenn eine Konstante in mehr als einem Register_Set angezeigt wird, jedoch kein Speicherplatz in diesem Registersatz zugewiesen ist.

Da ein Sampler mehr als einmal in einer konstanten Tabelle angezeigt werden kann, kann diese Methode ein Array von Beschreibungen zurückgeben, die jeweils einen anderen Registerindex aufweisen.

Anforderungen

Anforderung	Wert
Header	D3DX9Shader.h
Bibliothek	D3dx9.lib

Siehe auch

ID3DXConstantTable

ID3DXConstantTable::GetDesc