The array interfaces make it possible for your application to group objects into arrays, making it simpler to apply operations to the entire group. The following array interfaces are available:
The IDirect3DRMArray interface organizes groups of objects. Applications typically use the particular array interface they need (for example, IDirect3DRMFaceArray), rather than using this interface directly.
The IDirect3DRMArray interface supports the GetSize method.
The IDirect3DRMArray interface, like all Component Object Model (COM) interfaces, inherits the IUnknown interface methods. This interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
Retrieves the size, in number of objects, of the Direct3DRMArray object.
DWORD GetSize( );
Returns the size.
Applications use the methods of the IDirect3DRMDeviceArray interface to organize device objects. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMDevice, IDirect3DRMDevice2, and IDirect3DRMDeviceArray Interfaces.
The IDirect3DRMDeviceArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMDeviceArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMDeviceArray object is obtained by calling the IDirect3DRM::GetDevices method.
Retrieves a specified element in a Direct3DRMDeviceArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMDEVICE * lplpD3DRMDevice
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMDeviceArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMFaceArray interface to organize faces in a mesh. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMFace and IDirect3DRMFaceArray Interfaces.
The IDirect3DRMFaceArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMFaceArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMFaceArray object is obtained by calling the IDirect3DRMMeshBuilder::GetFaces method.
Retrieves a specified element in a Direct3DRMFaceArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMFACE * lplpD3DRMFace
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMFaceArray object.
DWORD GetSize( );
Returns the number of elements.
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 IDirect3DRMFrame, IDirect3DRMFrame2, and IDirect3DRMFrameArray Interfaces.
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 IDirect3DRMFrame::GetChildren method.
Retrieves a specified element in a Direct3DRMFrameArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMFRAME * lplpD3DRMFrame
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMFrameArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMLightArray interface to organize light objects. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMLight and IDirect3DRMLightArray Interfaces.
The IDirect3DRMLightArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMLightArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMLightArray object is obtained by calling the IDirect3DRMFrame::GetLights method.
Retrieves a specified element in a Direct3DRMLightArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMLIGHT * lplpD3DRMLight
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMLightArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMObjectArray interface to organize Direct3DRMObject objects. This section is a reference to the methods of this interface. For a conceptual overview, see Direct3DRMObject.
The IDirect3DRMObjectArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMObjectArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMObjectArray object is obtained by calling the IDirect3DRMInterpolator::GetAttachedObjects method.
Retrieves a specified element in a Direct3DRMObjectArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMOBJECT * lplpD3DRMObject
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMObjectArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMPickedArray interface to organize pick objects. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMPickedArray and IDirect3DRMPicked2Array Interfaces.
The IDirect3DRMPickedArray interface supports the following methods:
| GetPick |
| GetSize |
The IDirect3DRMPickedArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMPickedArray object is obtained by calling the IDirect3DRMViewport::Pick method.
Retrieves the Direct3DRMVisual and Direct3DRMFrame objects intersected by the specified pick.
HRESULT GetPick(
DWORD index,
LPDIRECT3DRMVISUAL * lplpVisual,
LPDIRECT3DRMFRAMEARRAY * lplpFrameArray,
LPD3DRMPICKDESC lpD3DRMPickDesc
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMPickedArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMPicked2Array interface to organize pick objects and to return more information about the pick objects. The D3DRMPICKDESC2 structure returned by IDirect3DRMPicked2Array::GetPick contains the face and group identifiers, pick position, horizontal and vertical texture coordinates for the vertex, vertex normal, and color of the intersected objects. A pointer to this interface pointer is returned in the IDirect3DRMFrame2::RayPick method during ray picks.
This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMPickedArray and IDirect3DRMPicked2Array Interfaces.
The IDirect3DRMPicked2Array interface supports the following methods:
| GetPick |
| GetSize |
The IDirect3DRMPicked2Array interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMPicked2Array object is obtained by calling the IDirect3DRMFrame2::RayPick method.
Retrieves the Direct3DRMVisual and Direct3DRMFrame objects intersected by the specified pick.
HRESULT GetPick(
DWORD index,
LPDIRECT3DRMVISUAL * lplpVisual,
LPDIRECT3DRMFRAMEARRAY * lplpFrameArray,
LPD3DRMPICKDESC2 lpD3DRMPickDesc2
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Return Values.
Retrieves the number of elements contained in a Direct3DRMPicked2Array object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMViewportArray interface to organize viewport objects. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMViewport and IDirect3DRMViewportArray Interface.
The IDirect3DRMViewportArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMViewportArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMViewportArray object is obtained by calling the IDirect3DRM::CreateFrame method.
Retrieves a specified element in a Direct3DRMViewportArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMVIEWPORT * lplpD3DRMViewport
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMViewportArray object.
DWORD GetSize( );
Returns the number of elements.
Applications use the methods of the IDirect3DRMVisualArray interface to organize groups of visual objects. This section is a reference to the methods of this interface. For a conceptual overview, see IDirect3DRMVisual and IDirect3DRMVisualArray Interfaces.
The IDirect3DRMVisualArray interface supports the following methods:
| GetElement |
| GetSize |
The IDirect3DRMVisualArray interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
| AddRef |
| QueryInterface |
| Release |
The Direct3DRMVisualArray object is obtained by calling the IDirect3DRMFrame::GetVisuals method.
Retrieves a specified element in a Direct3DRMVisualArray object.
HRESULT GetElement(
DWORD index,
LPDIRECT3DRMVISUAL * lplpD3DRMVisual
);
Returns D3DRM_OK if successful, or an error otherwise. For a list of possible errors, see Direct3D Retained Mode Return Values.
Retrieves the number of elements contained in a Direct3DRMVisualArray object.
DWORD GetSize( );
Returns the number of elements.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.