CoRegisterDeviceCatalog, fonction (combaseapi.h)

Permet à une DLL téléchargée d’inscrire ses interfaces de catalogue d’appareils Media Foundation Transform (MFT) dans son processus en cours d’exécution afin que le code de marshaling puisse marshaler ces interfaces.

Syntaxe

HRESULT CoRegisterDeviceCatalog(
  PCWSTR                   deviceInstanceId,
  CO_DEVICE_CATALOG_COOKIE *cookie
);

Paramètres

deviceInstanceId

Type : _In_ PCWSTR

Chaîne terminée par null contenant l’identificateur instance de l’appareil à inscrire.

cookie

Type : _Out_ CO_DEVICE_CATALOG_COOKIE*

Retourne une instance de CO_DEVICE_CATALOG_COOKIE. Vous pouvez utiliser cette valeur pour révoquer le catalogue d’appareils à l’aide de CoRevokeDeviceCatalog.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et S_OK.

Notes

Exemples

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;
}

Configuration requise

Voir aussi

• CoRevokeDeviceCatalog