ID3DXAllocateHierarchy::CreateFrame Method

Requests allocation of a frame object.

Syntax

HRESULT CreateFrame(      

    LPCSTR pMesh,
    LPD3DXFRAME *ppNewFrame
);

Parameters

pMesh

[in] Name of the frame to be created.

ppNewFrame

[out, retval] Returns the created frame object.

Return Value

The return values of this method are implemented by an application programmer. In general, if no error occurs, program the method to return D3D_OK. Otherwise, program the method to return an appropriate error message from D3DERR or D3DXERR, as this will cause D3DXLoadMeshHierarchyFromX to fail also, and return the error.