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 , DMO_REGISTERF_IS_KEYED = 1 }
enum	DMO_ENUM_FLAGS { DMO_ENUMF_INCLUDE_KEYED = 1 , 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
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
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 674 of file dmoreg.c.

{
    TRACE("%s 0x%08lx %ld %p %ld %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 %ld - 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 %ld - 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);
}

DMOGetName()

HRESULT WINAPI DMOGetName	(	REFCLSID	clsidDMO,
		WCHAR	name[80]
	)

Definition at line 282 of file dmoreg.c.

{
    static const INT max_name_len = 80*sizeof(WCHAR);
    DWORD count = max_name_len;
    WCHAR szguid[64];
    HKEY hrkey, hkey;
    LONG ret;
 
    TRACE("%s %p\n", debugstr_guid(clsidDMO), name);
 
    if (RegOpenKeyExW(HKEY_CLASSES_ROOT, L"DirectShow\\MediaObjects", 0, KEY_READ, &hrkey))
        return E_FAIL;
 
    ret = RegOpenKeyExW(hrkey, GUIDToString(szguid, clsidDMO), 0, KEY_READ, &hkey);
    RegCloseKey(hrkey);
    if (ret)
        return E_FAIL;
 
    ret = RegQueryValueExW(hkey, NULL, NULL, NULL, (LPBYTE)name, &count);
    RegCloseKey(hkey);
 
    if (!ret && count > 1)
    {
        TRACE("name=%s\n", debugstr_w(name));
        return S_OK;
    }
 
    name[0] = 0;
    return S_FALSE;
}

DMOGetTypes()

HRESULT WINAPI DMOGetTypes	(	REFCLSID	clsid,
		ULONG	input_count,
		ULONG *	ret_input_count,
		DMO_PARTIAL_MEDIATYPE *	input,
		ULONG	output_count,
		ULONG *	ret_output_count,
		DMO_PARTIAL_MEDIATYPE *	output
	)

Definition at line 722 of file dmoreg.c.

{
    WCHAR guidstr[64];
    HKEY root, key;
    LSTATUS ret;
    DWORD size;
 
    TRACE("clsid %s, input_count %lu, ret_input_count %p, input %p, output_count %lu, ret_output_count %p, output %p.\n",
            debugstr_guid(clsid), input_count, ret_input_count, input, output_count, ret_output_count, output);
 
    if (RegOpenKeyExW(HKEY_CLASSES_ROOT, L"DirectShow\\MediaObjects", 0, KEY_READ, &root))
        return E_FAIL;
 
    if (RegOpenKeyExW(root, GUIDToString(guidstr, clsid), 0, KEY_READ, &key))
    {
        RegCloseKey(root);
        return E_FAIL;
    }
 
    *ret_input_count = 0;
    size = input_count * sizeof(DMO_PARTIAL_MEDIATYPE);
    ret = RegQueryValueExW(key, L"InputTypes", NULL, NULL, (BYTE *)input, &size);
    if (!ret || ret == ERROR_MORE_DATA)
        *ret_input_count = min(input_count, size / sizeof(DMO_PARTIAL_MEDIATYPE));
 
    *ret_output_count = 0;
    size = output_count * sizeof(DMO_PARTIAL_MEDIATYPE);
    ret = RegQueryValueExW(key, L"OutputTypes", NULL, NULL, (BYTE *)output, &size);
    if (!ret || ret == ERROR_MORE_DATA)
        *ret_output_count = min(output_count, size / sizeof(DMO_PARTIAL_MEDIATYPE));
 
    RegCloseKey(key);
    RegCloseKey(root);
    return S_OK;
}

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 126 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, L"DirectShow\\MediaObjects", 0,
            NULL, 0, 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,
        (wcslen(szName) + 1) * sizeof(WCHAR));
 
    /* Set InputTypes */
    hres = write_types(hkey, L"InputTypes", pInTypes, cInTypes);
 
    /* Set OutputTypes */
    hres = write_types(hkey, L"OutputTypes", pOutTypes, cOutTypes);
 
    if (dwFlags & DMO_REGISTERF_IS_KEYED)
    {
        /* Create Keyed key */ 
        ret = RegCreateKeyExW(hkey, L"Keyed", 0, NULL, 0, KEY_WRITE, NULL, &hckey, NULL);
        if (ret)
            goto lend;
        RegCloseKey(hckey);
    }
 
    /* Register the category */
    ret = RegCreateKeyExW(hrkey, L"Categories", 0, NULL, 0, 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%08lx\n", hres);
    return hres;
}

DMOUnregister()

HRESULT WINAPI DMOUnregister	(	REFCLSID	dmo,
		REFGUID	category
	)

Definition at line 231 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));
 
    if (RegOpenKeyExW(HKEY_CLASSES_ROOT, L"DirectShow\\MediaObjects", 0, KEY_WRITE, &rootkey))
        return S_FALSE;
 
    GUIDToString(dmoW, dmo);
    RegDeleteKeyW(rootkey, dmoW);
 
    /* open 'Categories' */
    ret = RegOpenKeyExW(rootkey, L"Categories", 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;
}