POSITION (Compact 2013)

3/26/2014

This structure specifies a placeholder for a linked list.

Syntax

struct __POSITION { int unused; };
typedef __POSITION* POSITION;

Members

• unused
  Integer value that specifies the location of an item in a linked list.

Remarks

This structure can point to any element in a linked list, including null elements (such as an end-of-list marker). This structure will, however, become invalid if you delete the item it points to.

When you perform operations that return a POSITION pointer on a single list element, a successful operation sets it to an appropriate non-null value, while NULL indicates that the items position could not be found.

When you perform operations on the entire list, the pointer represents a Win32 BOOLEAN value, where TRUE indicates success and FALSE indicates failure.

Requirements

See Also

Reference

DirectShow Structures
CBaseList::GetHeadPositionI
CBaseList::GetTailPositionI