Metodo IMFMediaSession::GetFullTopology (mfidl.h)

Ottiene una topologia dalla sessione multimediale.

Questo metodo può ottenere la topologia corrente o una topologia in coda.

Sintassi

HRESULT GetFullTopology(
  [in]  DWORD       dwGetFullTopologyFlags,
  [in]  TOPOID      TopoId,
  [out] IMFTopology **ppFullTopology
);

Parametri

[in] dwGetFullTopologyFlags

OR bit per bit di zero o più flag dall'enumerazione MFSESSION_GETFULLTOPOLOGY_FLAGS.

[in] TopoId

Identificatore della topologia. Questo parametro viene ignorato se il parametro dwGetFullTopologyFlags contiene il flag MFSESSION_GETFULLTOPOLOGY_CURRENT . Per ottenere l'identificatore di una topologia, chiamare IMFTopology::GetTopologyID.

[out] ppFullTopology

Riceve un puntatore all'interfaccia IMFTopology della topologia. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_SHUTDOWN	La sessione multimediale è stata arrestata.

Commenti

Se il flag MFSESSION_GETFULLTOPOLOGY_CURRENT viene specificato nel parametro dwGetFullTopologyFlags , il metodo restituisce la topologia per la presentazione corrente. In caso contrario, il metodo esegue la ricerca di una delle topologie in coda corrispondente all'identificatore specificato nel parametro TopoId .

Questo metodo può essere utilizzato per recuperare la topologia per la presentazione corrente o le presentazioni in sospeso. Non può essere usato per recuperare una topologia già terminata.

La topologia restituita in ppFullTopo è una topologia completa, non una topologia parziale.

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

IMFMediaSession

TOPOID