Edit

IKsTopology::CreateNodeInstance method (ksproxy.h)

  • Article

The CreateNodeInstance method requests a KS filter object to open a topology node object.

Syntax

HRESULT CreateNodeInstance(
  [in]           ULONG       NodeId,
  [in]           ULONG       Flags,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] IUnknown    *UnkOuter,
  [in]           REFGUID     InterfaceId,
  [out]          LPVOID      *Interface
);

Parameters

[in] NodeId

Identifier for the topology node object to open.

[in] Flags

A bitmask enumerating the type of topology node object. No flags are currently defined.

[in] DesiredAccess

An ACCESS_MASK bitmask specifying the type of access that the caller requires to the topology node object. See ZwCreateFile for a description of each access-right value.

[in, optional] UnkOuter

Pointer to an IUnknown interface that supports the topology node interface.

[in] InterfaceId

Identifier of the topology node interface being requested.

[out] Interface

Pointer to a variable that receives the interface pointer requested in InterfaceId. Upon successful return, *Interface contains the requested interface pointer to the object. If the object does not support the interface specified in InterfaceId, *Interface is set to NULL.

Return value

Returns NOERROR if successful; otherwise, returns an error code.

Requirements

Requirement Value
Target Platform DesktopMobile
Header ksproxy.h (include Ksproxy.h)

See also

ACCESS_MASK

IKsTopology

ZwCreateFile