Desbloquear o SDK de Formato de Mídia do Windows

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Para acessar a versão 7 ou 7.1 do SDK do Windows Media Format, um aplicativo deve fornecer um certificado de software, também chamado de chave, em tempo de execução. Essa chave está contida em uma biblioteca estática chamada wmstub.lib à qual o aplicativo é vinculado no momento da compilação. Uma chave individualizada só é necessária para criar ou ler arquivos protegidos por DRM. Arquivos não DRM podem ser criados usando a biblioteca estática fornecida com o SDK de Formato de Mídia do Windows. Para obter detalhes sobre como obter a chave DRM, consulte o SDK do Formato de Mídia do Windows. Um aplicativo DirectShow fornece seu certificado para o Gravador ASF do WM quando ele é adicionado ao grafo de filtro. O aplicativo deve se registrar como um provedor de chaves usando as interfaces COM IServiceProvider e IObjectWithSite . Usando essa técnica, o aplicativo implementa uma classe de provedor de chave derivada de IServiceProvider. Essa classe implementa os três métodos COM padrão: AddRef, QueryInterface e Release, juntamente com um método adicional, QueryService, que é chamado pelo gerenciador de grafo de filtro. QueryService chama o método WMCreateCertificate do Windows Media Format e retorna ao gerenciador de grafo de filtro um ponteiro para o certificado que foi criado. Se o certificado for válido, o gerenciador de grafo de filtro permitirá que o processo de criação de grafo prossiga.

Observação

Para criar um aplicativo, inclua Wmsdkidl.h para o protótipo de WMCreateCertificate e vincule-se à biblioteca Wmstub.lib.

 

O exemplo de código a seguir ilustra as etapas básicas neste processo:

// Declare and implement a key provider class derived from IServiceProvider.

class CKeyProvider : public IServiceProvider {
public:
    // IUnknown interface
    STDMETHODIMP QueryInterface(REFIID riid, void ** ppv);
    STDMETHODIMP_(ULONG) AddRef();
    STDMETHODIMP_(ULONG) Release();

    CKeyProvider();

    // IServiceProvider
    STDMETHODIMP QueryService(REFIID siid, REFIID riid, void **ppv);
    
private:
    ULONG m_cRef;
};

CKeyProvider::CKeyProvider() : m_cRef(0)
{
}

// IUnknown methods
ULONG CKeyProvider::AddRef()
{
    return InterlockedIncrement(&m_cRef);
}

ULONG CKeyProvider::Release()
{
    ASSERT(m_cRef > 0);

    ULONG lCount = InterlockedDecrement(&m_cRef);
    if (m_cRef == 0) 
    {
        delete this;
        return (ULONG)0;
    }
    return (ULONG)lCount;
}

// We only support IUnknown and IServiceProvider.
HRESULT CKeyProvider::QueryInterface(REFIID riid, void ** ppv)
{
    if (!ppv) return E_POINTER;

    if (riid == IID_IUnknown) 
    {
        *ppv = (void *) static_cast<IUnknown *>(this);
        AddRef();
        return S_OK;
    }
    if (riid == IID_IServiceProvider) 
    {
        *ppv = (void *) static_cast<IServiceProvider *>(this);
        AddRef();
        return S_OK;
    }

    return E_NOINTERFACE;
}

STDMETHODIMP CKeyProvider::QueryService(REFIID siid, REFIID riid, void **ppv)
{
    if (!ppv) return E_POINTER;

    if (siid == __uuidof(IWMReader) && riid == IID_IUnknown) 
    {
        IUnknown *punkCert;
        HRESULT hr = WMCreateCertificate(&punkCert);
        if (SUCCEEDED(hr)) 
        {
            *ppv = (void *) punkCert;
        }
        return hr;
    }
    return E_NOINTERFACE;
}

////////////////////////////////////////////////////////////////////
//
// These examples illustrate the sequence of method calls
// in your application. Error checking is omitted for brevity.
//
///////////////////////////////////////////////////////////////////

// Create the filter graph manager, but don't add any filters.
IGraphBuilder *pGraph;
hr = CreateFilterGraph(&pGraph);

...

// Instantiate the key provider class, and AddRef it
// so that COM doesn't try to free our static object.

CKeyProvider prov;
prov.AddRef();  // Don't let COM try to free our static object.

// Give the graph an IObjectWithSite pointer for callbacks and QueryService.
IObjectWithSite* pObjectWithSite = NULL;

hr = pGraph->QueryInterface(IID_IObjectWithSite, (void**)&pObjectWithSite);
if (SUCCEEDED(hr))
{
    // Use the IObjectWithSite pointer to specify our key provider object.
    // The filter graph manager will use this pointer to call
    // QueryService to do the unlocking.
    // If the unlocking succeeds, then we can build our graph.

    pObjectWithSite->SetSite((IUnknown *) (IServiceProvider *) &prov);
    pObjectWithSite->Release();
}

// Now build the graph.

Tópicos relacionados

Criando arquivos ASF no DirectShow