Metodo IMFASFProfile::GetMutualExclusion (wmcontainer.h)

Articolo
08/28/2023

Recupera un oggetto di esclusione reciproca di Advanced Systems Format (ASF) dal profilo.

Sintassi

HRESULT GetMutualExclusion(
  [in]  DWORD                 dwMutexIndex,
  [out] IMFASFMutualExclusion **ppIMutex
);

Parametri

[in] dwMutexIndex

Indice dell'oggetto di esclusione reciproca nel profilo.

[out] ppIMutex

Riceve un puntatore all'interfaccia FMASFMutualExclusion dell'oggetto di esclusione reciproca ASF. Il chiamante deve rilasciare l'interfaccia.

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

Questo metodo non crea una copia dell'oggetto di esclusione reciproca. Il puntatore restituito fa riferimento all'esclusione reciproca contenuta nell'oggetto profile. Non è necessario apportare modifiche all'oggetto di esclusione reciproca usando questo puntatore, perché ciò può influire sull'oggetto profilo in modi imprevisti.

Per modificare la configurazione dell'oggetto di esclusione reciproca nel profilo, è prima necessario clonare l'oggetto di esclusione reciproca chiamando FMASFMutualExclusion::Clone. Apportare le modifiche necessarie al clone dell'oggetto, rimuovere l'oggetto di esclusione reciproca precedente dal profilo chiamando il metodo FMASFProfile::RemoveMutualExclusion e quindi aggiungere l'oggetto aggiornato chiamando il metodo IMFASFProfile::AddMutualExclusion .

Requisiti


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