IBDA_Topology::GetNodeTypes method (bdaiface.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The GetNodeTypes method retrieves a list of all the node types in the template topology for this filter and network type.

Syntax

HRESULT GetNodeTypes(
  [out] ULONG    *pulcNodeTypes,
  [in]  ULONG    ulcNodeTypesMax,
  [out] ULONG [] rgulNodeTypes
);

Parameters

[out] pulcNodeTypes

Pointer that receives the number of node types in the list.

[in] ulcNodeTypesMax

The maximum number of node types that can be held by the rgulNodeTypes buffer.

[out] rgulNodeTypes

Pointer to a buffer that receives the list of node types.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

The IBDA_Topology interface is implemented by a BDA Device Filter. It is used by a Network Provider to query a BDA Device Filter's possible topologies (template topology) and to configure the device with an appropriate topology for the current tuning request. It is also used to get an IUnknown to a control node which may be used to set specific tuning information.

Requirements

See also

Error and Success Codes

IBDA_Topology Interface