IDirect3DRMFrameArray

Applications use the methods of the IDirect3DRMFrameArray interface to organize frame objects. This section is a reference to the methods of this interface. For a conceptual overview, see Frames.

The IDirect3DRMFrameArray interface supports the following methods:

GetElement
GetSize

The IDirect3DRMFrameArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:

AddRef
QueryInterface
Release

The Direct3DRMFrameArray object is obtained by calling the IDirect3DRMPickedArray::GetPick, IDirect3DRMPicked2Array::GetPick, or IDirect3DRMFrame3::GetChildren method.

IDirect3DRMFrameArray::GetElement

IDirect3DRMFrameArray

Retrieves a specified element in a Direct3DRMFrameArray object.

Syntax

HRESULT GetElement(
  DWORD index,
  LPDIRECT3DRMFRAME  *lplpD3DRMFrame
  );

Parameters

index
Element in the array.
lplpD3DRMFrame
Address that will be filled with a pointer to an IDirect3DRMFrame interface.

Return Value

Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.

Remarks

You can use QueryInterface to obtain a pointer to the version of IDirect3DRMFrame that you want, for example, IDirect3DRMFrame3. You cannot simply cast the lplpD3DRMFrame parameter to a different version. You must use QueryInterface.

IDirect3DRMFrameArray::GetSize

IDirect3DRMFrameArray

Retrieves the number of elements contained in a Direct3DRMFrameArray object.

Syntax

DWORD GetSize( );

Return Value

Returns the number of elements.