CoRegisterDeviceCatalog-Funktion (combaseapi.h)

  • Artikel

Ermöglicht einer heruntergeladenen DLL die Registrierung ihrer MFT-Gerätekatalogschnittstellen (Media Foundation Transform) innerhalb des ausgeführten Prozesses, sodass der Marshallingcode diese Schnittstellen marshallen kann.

Syntax

HRESULT CoRegisterDeviceCatalog(
  PCWSTR                   deviceInstanceId,
  CO_DEVICE_CATALOG_COOKIE *cookie
);

Parameter

deviceInstanceId

Typ: _In_ PCWSTR

Eine NULL-endende Zeichenfolge, die den instance Bezeichner des zu registrierenden Geräts enthält.

cookie

Typ: _Out_ CO_DEVICE_CATALOG_COOKIE*

Gibt einen instance von CO_DEVICE_CATALOG_COOKIE zurück. Sie können diesen Wert verwenden, um den Gerätekatalog mit CoRevokeDeviceCatalog zu widerrufen.

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und S_OK zurückgeben.

Bemerkungen

Beispiele

std::vector<CO_DEVICE_CATALOG_COOKIE> g_deviceCatalogsCookies;

HRESULT MFStartup(ULONG Version, DWORD dwFlags)
{
    // current MFStartup code elided.
    std::wstring devices{ /* set of device IDs of interest */ };
    for (const auto& device : devices)
    {
        CO_DEVICE_CATALOG_COOKIE cookie{};
        RETURN_IF_FAILED(CoRegisterDeviceCatalog(device.c_str(), &cookie));
        g_deviceCatalogsCookies.push_back(cookie);
    }

    return S_OK;
}

HRESULT STDMETHODCALLTYPE MFShutdown()
{
    // current MFShutdown code elided
    for (auto catalogCookie : g_deviceCatalogsCookies)
    {
        CoRevokeDeviceCatalog(catalogCookie);
    }

    return S_OK;
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server) Windows Server, Version 2004 (10.0; Build 19041)
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen