Metodo IMFContentProtectionManager::BeginEnableContent (mfidl.h)

Articolo
02/28/2024

Avvia una richiesta asincrona per eseguire un'azione di abilitazione del contenuto.

Questo metodo richiede all'applicazione di eseguire un passaggio specifico necessario per acquisire i diritti per il contenuto, usando un oggetto di abilitazione del contenuto.

Sintassi

HRESULT BeginEnableContent(
  [in] IMFActivate      *pEnablerActivate,
  [in] IMFTopology      *pTopo,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parametri

[in] pEnablerActivate

Puntatore all'interfaccia FMActivate di un oggetto di abilitazione del contenuto. Per creare l'abilitazione del contenuto, chiamare FMActivate::ActivateObject e richiedere l'interfaccia FMContentEnabler . L'applicazione deve usare i metodi in FMContentEnabler per completare l'azione di abilitazione del contenuto.

[in] pTopo

Puntatore all'interfaccia FMTo topologia della topologia in sospeso.

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Al termine dell'operazione, l'applicazione deve chiamare FMAsyncCallback::Invoke sul callback.

[in] punkState

Riservato. Attualmente questo parametro è sempre NULL.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Non bloccare all'interno di questo metodo di callback. Eseguire invece l'azione di abilitazione del contenuto in modo asincrono in un altro thread. Al termine dell'operazione, notificare il percorso multimediale protetto (PMP) tramite il parametro pCallback .

Se si restituisce un codice di esito positivo da questo metodo, è necessario chiamare Invoke nel callback. Al contrario, se si restituisce un codice di errore da questo metodo, non è necessario chiamare Invoke. Se l'operazione ha esito negativo dopo che il metodo restituisce un codice di esito positivo, usare il codice di stato nell'oggetto IMFAsyncResult per segnalare l'errore.

Dopo aver richiamato il callback, il PMP chiamerà il metodo FMContentProtectionManager::EndEnableContent per completare la chiamata asincrona.

Questo metodo non viene necessariamente chiamato ogni volta che l'applicazione riproduce contenuto protetto. In genere, il metodo non verrà chiamato se l'utente ha una licenza valida e aggiornata per il contenuto. Internamente, l'autorità di attendibilità di input (ITA) determina se BeginEnableContent viene chiamato, in base ai criteri DRM del provider di contenuto. Per altre informazioni, vedere Percorso multimediale protetto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfuuid.lib

Vedi anche

FMIActivate

IMFContentProtectionManager

Condividi tramite