dmoreg.h File Reference

#include "mediaobj.h"

Include dependency graph for dmoreg.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_DMO_PARTIAL_MEDIATYPE

Typedefs
typedef struct _DMO_PARTIAL_MEDIATYPE	DMO_PARTIAL_MEDIATYPE
typedef struct _DMO_PARTIAL_MEDIATYPE *	PDMO_PARTIAL_MEDIATYPE

Enumerations
enum	DMO_REGISTER_FLAGS { DMO_REGISTERF_IS_KEYED = 1 }
enum	DMO_ENUM_FLAGS { DMO_ENUMF_INCLUDE_KEYED = 1 }

Functions
HRESULT WINAPI	DMORegister (LPCWSTR, REFCLSID, REFGUID, DWORD, DWORD, const DMO_PARTIAL_MEDIATYPE *, DWORD, const DMO_PARTIAL_MEDIATYPE *)
HRESULT WINAPI	DMOUnregister (REFCLSID, REFGUID)
HRESULT WINAPI	DMOEnum (REFGUID, DWORD, DWORD, const DMO_PARTIAL_MEDIATYPE *, DWORD, const DMO_PARTIAL_MEDIATYPE *, IEnumDMO **)
HRESULT WINAPI	DMOGetTypes (REFCLSID, ULONG, ULONG *, DMO_PARTIAL_MEDIATYPE *, ULONG, ULONG *, DMO_PARTIAL_MEDIATYPE *)
HRESULT WINAPI	DMOGetName (REFCLSID, WCHAR[80])
	DEFINE_GUID (DMOCATEGORY_AUDIO_DECODER, 0x57f2db8b, 0xe6bb, 0x4513, 0x9d, 0x43, 0xdc, 0xd2, 0xa6, 0x59, 0x31, 0x25)
	DEFINE_GUID (DMOCATEGORY_AUDIO_ENCODER, 0x33d9a761, 0x90c8, 0x11d0, 0xbd, 0x43, 0x00, 0xa0, 0xc9, 0x11, 0xce, 0x86)
	DEFINE_GUID (DMOCATEGORY_VIDEO_DECODER, 0x4a69b442, 0x28be, 0x4991, 0x96, 0x9c, 0xb5, 0x00, 0xad, 0xf5, 0xd8, 0xa8)
	DEFINE_GUID (DMOCATEGORY_VIDEO_ENCODER, 0x33d9a760, 0x90c8, 0x11d0, 0xbd, 0x43, 0x00, 0xa0, 0xc9, 0x11, 0xce, 0x86)
	DEFINE_GUID (DMOCATEGORY_AUDIO_EFFECT, 0xf3602b3f, 0x0592, 0x48df, 0xa4, 0xcd, 0x67, 0x47, 0x21, 0xe7, 0xeb, 0xeb)
	DEFINE_GUID (DMOCATEGORY_VIDEO_EFFECT, 0xd990ee14, 0x776c, 0x4723, 0xbe, 0x46, 0x3d, 0xa2, 0xf5, 0x6f, 0x10, 0xb9)
	DEFINE_GUID (DMOCATEGORY_AUDIO_CAPTURE_EFFECT, 0xf665aaba, 0x3e09, 0x4920, 0xaa, 0x5f, 0x21, 0x98, 0x11, 0x14, 0x8f, 0x09)
	DEFINE_GUID (DMOCATEGORY_ACOUSTIC_ECHO_CANCEL, 0xbf963d80, 0xc559, 0x11d0, 0x8a, 0x2b, 0x00, 0xa0, 0xc9, 0x25, 0x5a, 0xc1)
	DEFINE_GUID (DMOCATEGORY_AUDIO_NOISE_SUPPRESS, 0xe07f903f, 0x62fd, 0x4e60, 0x8c, 0xdd, 0xde, 0xa7, 0x23, 0x66, 0x65, 0xb5)
	DEFINE_GUID (DMOCATEGORY_AGC, 0xe88c9ba0, 0xc557, 0x11d0, 0x8a, 0x2b, 0x00, 0xa0, 0xc9, 0x25, 0x5a, 0xc1)

Typedef Documentation

DMO_PARTIAL_MEDIATYPE

typedef struct _DMO_PARTIAL_MEDIATYPE DMO_PARTIAL_MEDIATYPE

PDMO_PARTIAL_MEDIATYPE

typedef struct _DMO_PARTIAL_MEDIATYPE * PDMO_PARTIAL_MEDIATYPE

Enumeration Type Documentation

DMO_ENUM_FLAGS

enum DMO_ENUM_FLAGS

Enumerator
DMO_ENUMF_INCLUDE_KEYED

Definition at line 35 of file dmoreg.h.

{
   DMO_ENUMF_INCLUDE_KEYED = 1
};

DMO_REGISTER_FLAGS

enum DMO_REGISTER_FLAGS

Enumerator
DMO_REGISTERF_IS_KEYED

Definition at line 30 of file dmoreg.h.

{
   DMO_REGISTERF_IS_KEYED = 1
};

Function Documentation

DEFINE_GUID() [1/10]

DEFINE_GUID	(	DMOCATEGORY_ACOUSTIC_ECHO_CANCEL	,
		0xbf963d80	,
		0xc559	,
		0x11d0	,
		0x8a	,
		0x2b	,
		0x00	,
		0xa0	,
		0xc9	,
		0x25	,
		0x5a	,
		0xc1
	)

DEFINE_GUID() [2/10]

DEFINE_GUID	(	DMOCATEGORY_AGC	,
		0xe88c9ba0	,
		0xc557	,
		0x11d0	,
		0x8a	,
		0x2b	,
		0x00	,
		0xa0	,
		0xc9	,
		0x25	,
		0x5a	,
		0xc1
	)

DEFINE_GUID() [3/10]

DEFINE_GUID	(	DMOCATEGORY_AUDIO_CAPTURE_EFFECT	,
		0xf665aaba	,
		0x3e09	,
		0x4920	,
		0xaa	,
		0x5f	,
		0x21	,
		0x98	,
		0x11	,
		0x14	,
		0x8f	,
		0x09
	)

DEFINE_GUID() [4/10]

DEFINE_GUID	(	DMOCATEGORY_AUDIO_DECODER	,
		0x57f2db8b	,
		0xe6bb	,
		0x4513	,
		0x9d	,
		0x43	,
		0xdc	,
		0xd2	,
		0xa6	,
		0x59	,
		0x31	,
		0x25
	)

DEFINE_GUID() [5/10]

DEFINE_GUID	(	DMOCATEGORY_AUDIO_EFFECT	,
		0xf3602b3f	,
		0x0592	,
		0x48df	,
		0xa4	,
		0xcd	,
		0x67	,
		0x47	,
		0x21	,
		0xe7	,
		0xeb	,
		0xeb
	)

DEFINE_GUID() [6/10]

DEFINE_GUID	(	DMOCATEGORY_AUDIO_ENCODER	,
		0x33d9a761	,
		0x90c8	,
		0x11d0	,
		0xbd	,
		0x43	,
		0x00	,
		0xa0	,
		0xc9	,
		0x11	,
		0xce	,
		0x86
	)

DEFINE_GUID() [7/10]

DEFINE_GUID	(	DMOCATEGORY_AUDIO_NOISE_SUPPRESS	,
		0xe07f903f	,
		0x62fd	,
		0x4e60	,
		0x8c	,
		0xdd	,
		0xde	,
		0xa7	,
		0x23	,
		0x66	,
		0x65	,
		0xb5
	)

DEFINE_GUID() [8/10]

DEFINE_GUID	(	DMOCATEGORY_VIDEO_DECODER	,
		0x4a69b442	,
		0x28be	,
		0x4991	,
		0x96	,
		0x9c	,
		0xb5	,
		0x00	,
		0xad	,
		0xf5	,
		0xd8	,
		0xa8
	)

DEFINE_GUID() [9/10]

DEFINE_GUID	(	DMOCATEGORY_VIDEO_EFFECT	,
		0xd990ee14	,
		0x776c	,
		0x4723	,
		0xbe	,
		0x46	,
		0x3d	,
		0xa2	,
		0xf5	,
		0x6f	,
		0x10	,
		0xb9
	)

DEFINE_GUID() [10/10]

DEFINE_GUID	(	DMOCATEGORY_VIDEO_ENCODER	,
		0x33d9a760	,
		0x90c8	,
		0x11d0	,
		0xbd	,
		0x43	,
		0x00	,
		0xa0	,
		0xc9	,
		0x11	,
		0xce	,
		0x86
	)

DMOEnum()

HRESULT WINAPI DMOEnum	(	REFGUID	category,
		DWORD	flags,
		DWORD	cInTypes,
		const DMO_PARTIAL_MEDIATYPE *	pInTypes,
		DWORD	cOutTypes,
		const DMO_PARTIAL_MEDIATYPE *	pOutTypes,
		IEnumDMO **	ppEnum
	)

Definition at line 732 of file dmoreg.c.

{
    TRACE("%s 0x%08x %d %p %d %p %p\n", debugstr_guid(category), flags, cInTypes, pInTypes,
        cOutTypes, pOutTypes, ppEnum);
 
    if (TRACE_ON(msdmo))
    {
        DWORD i;
        if (cInTypes)
        {
            for (i = 0; i < cInTypes; i++)
                TRACE("intype %d - type %s, subtype %s\n", i, debugstr_guid(&pInTypes[i].type),
                    debugstr_guid(&pInTypes[i].subtype));
        }
 
        if (cOutTypes) {
            for (i = 0; i < cOutTypes; i++)
                TRACE("outtype %d - type %s, subtype %s\n", i, debugstr_guid(&pOutTypes[i].type),
                    debugstr_guid(&pOutTypes[i].subtype));
        }
    }
 
    return IEnumDMO_Constructor(category, flags, cInTypes,
        pInTypes, cOutTypes, pOutTypes, ppEnum);
}

Referenced by create_EnumMoniker().

DMOGetName()

HRESULT WINAPI DMOGetName	(	REFCLSID	,
		WCHAR	[80]
	)

DMOGetTypes()

HRESULT WINAPI DMOGetTypes	(	REFCLSID	clsidDMO,
		ULONG	ulInputTypesRequested,
		ULONG *	pulInputTypesSupplied,
		DMO_PARTIAL_MEDIATYPE *	pInputTypes,
		ULONG	ulOutputTypesRequested,
		ULONG *	pulOutputTypesSupplied,
		DMO_PARTIAL_MEDIATYPE *	pOutputTypes
	)

Definition at line 857 of file dmoreg.c.

{
  HKEY root,hkey;
  HRESULT ret = S_OK;
  WCHAR szguid[64];
 
  TRACE ("(%s,%u,%p,%p,%u,%p,%p)\n", debugstr_guid(clsidDMO), ulInputTypesRequested,
        pulInputTypesSupplied, pInputTypes, ulOutputTypesRequested, pulOutputTypesSupplied,
        pOutputTypes);
 
  if (ERROR_SUCCESS != RegOpenKeyExW(HKEY_CLASSES_ROOT, szDMORootKey, 0,
                                     KEY_READ, &root))
    return E_FAIL;
 
  if (ERROR_SUCCESS != RegOpenKeyExW(root,GUIDToString(szguid,clsidDMO) , 0,
                                     KEY_READ, &hkey))
  {
    RegCloseKey(root);
    return E_FAIL;
  }
 
  if (ulInputTypesRequested > 0)
  {
    ret = read_types(hkey, szDMOInputType, pulInputTypesSupplied, ulInputTypesRequested, pInputTypes );
  }
  else
    *pulInputTypesSupplied = 0;
 
  if (ulOutputTypesRequested > 0)
  {
    HRESULT ret2;
    ret2 = read_types(hkey, szDMOOutputType, pulOutputTypesSupplied, ulOutputTypesRequested, pOutputTypes );
 
    if (ret == S_OK)
        ret = ret2;
  }
  else
    *pulOutputTypesSupplied = 0;
 
  return ret;
}

DMORegister()

HRESULT WINAPI DMORegister	(	LPCWSTR	szName,
		REFCLSID	clsidDMO,
		REFGUID	guidCategory,
		DWORD	dwFlags,
		DWORD	cInTypes,
		const DMO_PARTIAL_MEDIATYPE *	pInTypes,
		DWORD	cOutTypes,
		const DMO_PARTIAL_MEDIATYPE *	pOutTypes
	)

Definition at line 183 of file dmoreg.c.

{
    WCHAR szguid[64];
    HRESULT hres;
    HKEY hrkey = 0;
    HKEY hkey = 0;
    HKEY hckey = 0;
    HKEY hclskey = 0;
    LONG ret;
 
    TRACE("%s %s %s\n", debugstr_w(szName), debugstr_guid(clsidDMO), debugstr_guid(guidCategory));
 
    if (IsEqualGUID(guidCategory, &GUID_NULL))
        return E_INVALIDARG;
 
    ret = RegCreateKeyExW(HKEY_CLASSES_ROOT, szDMORootKey, 0, NULL,
        REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hrkey, NULL);
    if (ret)
        return E_FAIL;
 
    /* Create clsidDMO key under MediaObjects */ 
    ret = RegCreateKeyExW(hrkey, GUIDToString(szguid, clsidDMO), 0, NULL,
        REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hkey, NULL);
    if (ret)
        goto lend;
 
    /* Set default Name value */
    ret = RegSetValueExW(hkey, NULL, 0, REG_SZ, (const BYTE*) szName,
        (lstrlenW(szName) + 1) * sizeof(WCHAR));
 
    /* Set InputTypes */
    hres = write_types(hkey, szDMOInputType, pInTypes, cInTypes);
 
    /* Set OutputTypes */
    hres = write_types(hkey, szDMOOutputType, pOutTypes, cOutTypes);
 
    if (dwFlags & DMO_REGISTERF_IS_KEYED)
    {
        /* Create Keyed key */ 
        ret = RegCreateKeyExW(hkey, szDMOKeyed, 0, NULL,
            REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hckey, NULL);
        if (ret)
            goto lend;
        RegCloseKey(hckey);
    }
 
    /* Register the category */
    ret = RegCreateKeyExW(hrkey, szDMOCategories, 0, NULL,
            REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hckey, NULL);
    if (ret)
        goto lend;
 
    RegCloseKey(hkey);
 
    ret = RegCreateKeyExW(hckey, GUIDToString(szguid, guidCategory), 0, NULL,
            REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hkey, NULL);
    if (ret)
        goto lend;
    ret = RegCreateKeyExW(hkey, GUIDToString(szguid, clsidDMO), 0, NULL,
        REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hclskey, NULL);
    if (ret)
        goto lend;
 
lend:
    if (hkey)
        RegCloseKey(hkey);
    if (hckey)
        RegCloseKey(hckey);
    if (hclskey)
        RegCloseKey(hclskey);
    if (hrkey)
        RegCloseKey(hrkey);
 
    hres = HRESULT_FROM_WIN32(ret);
    TRACE(" hresult=0x%08x\n", hres);
    return hres;
}

Referenced by test_dmo().

DMOUnregister()

HRESULT WINAPI DMOUnregister	(	REFCLSID	dmo,
		REFGUID	category
	)

Definition at line 290 of file dmoreg.c.

{
    HKEY rootkey = 0, categorieskey = 0;
    WCHAR dmoW[64], catW[64];
    HRESULT hr = S_FALSE;
    LONG ret;
 
    TRACE("%s %s\n", debugstr_guid(dmo), debugstr_guid(category));
 
    ret = RegOpenKeyExW(HKEY_CLASSES_ROOT, szDMORootKey, 0, KEY_WRITE, &rootkey);
    if (ret)
        return S_FALSE;
 
    GUIDToString(dmoW, dmo);
    RegDeleteKeyW(rootkey, dmoW);
 
    /* open 'Categories' */
    ret = RegOpenKeyExW(rootkey, szDMOCategories, 0, KEY_WRITE|KEY_ENUMERATE_SUB_KEYS, &categorieskey);
    RegCloseKey(rootkey);
    if (ret)
    {
        hr = HRESULT_FROM_WIN32(ret);
        goto lend;
    }
 
    /* remove from all categories */
    if (IsEqualGUID(category, &GUID_NULL))
    {
        DWORD index = 0, len = ARRAY_SIZE(catW);
 
        while (!RegEnumKeyExW(categorieskey, index++, catW, &len, NULL, NULL, NULL, NULL))
            hr = unregister_dmo_from_category(dmoW, catW, categorieskey);
    }
    else
    {
        GUIDToString(catW, category);
        hr = unregister_dmo_from_category(dmoW, catW, categorieskey);
    }
 
lend:
    if (categorieskey)
        RegCloseKey(categorieskey);
 
    return hr;
}

Referenced by test_dmo().