INonDelegatingUnknown::INonDelegatingUnknown

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

A version of IUnknown renamed to enable a class to support both nondelegating and delegating IUnknown interfaces in the same COM object.

The interface supports the following three methods, in vtable order.

Syntax

HRESULT NonDelegatingQueryInterface(
  REFIID iid,
  void **ppvObject 
);
ULONG NonDelegatingAddRef(void);
ULONG NonDelegatingRelease(void);

Remarks

To use INonDelegatingUnknown for multiple inheritance, perform the following steps:

  1. Derive your class from an interface, for example, IMyInterface.

  2. Include DECLARE_IUNKNOWN in your class definition to declare implementations of QueryInterface, AddRef, and Release that call the outer unknown.

  3. Override NonDelegatingQueryInterface to expose IMyInterface with code such as the following.

         if (riid == IID_IMyInterface) {
             return GetInterface((IMyInterface *) this, ppv);
         } else {
             return CUnknown::NonDelegatingQueryInterface(riid, ppv);
         }
    
  4. Declare and implement the member functions of IMyInterface.

To use INonDelegatingUnknown for nested interfaces, perform the following steps:

  1. Declare a class derived from CUnknown.

  2. Include DECLARE_IUNKNOWN in your class definition.

  3. Override NonDelegatingQueryInterface to expose IMyInterface with the code such as the following:

         if (riid == IID_IMyInterface) {
             return GetInterface((IMyInterface *) this, ppv);
         } else {
             return CUnknown::NonDelegatingQueryInterface(riid, ppv);
         }
    
  4. Implement the member functions of IMyInterface.
    Use CUnknown::GetOwner to access the COM object class.

  5. In your COM object class, make the nested class a friend of the COM object class, and declare an instance of the nested class as a member of the COM object class.

Because you must always pass the outer unknown and an HRESULT to the CUnknown constructor, you cannot use a default constructor. You must make the member variable a pointer to the class and make a new call in your constructor to actually create it.

Override the NonDelegatingQueryInterface with code such as the following.

     if (riid == IID_IMyInterface) {
         return m_pImplFilter->
            NonDelegatingQueryInterface(IID_IMyInterface, ppv);
     } else {
         return CUnknown::NonDelegatingQueryInterface(riid, ppv);
     }

You can have mixed classes that support some interfaces through multiple inheritance and some interfaces through nested classes.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

INonDelegatingUnknown Interface