Metodo IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS (mfidl.h)

Registra le code di lavoro della topologia con il servizio MMCSS (Multimedia Class Scheduler Service).

Sintassi

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Parametri

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Il chiamante deve implementare questa interfaccia.

[in] pState

Puntatore all'interfaccia IUnknown di un oggetto di stato definito dal chiamante. Questo parametro può essere NULL. È possibile utilizzare questo oggetto per contenere le informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Ogni nodo di origine nella topologia definisce un ramo della topologia. Il ramo include ogni nodo della topologia che riceve i dati da tale nodo. Un'applicazione può assegnare ogni ramo di una topologia propria coda di lavoro e quindi associare tali code di lavoro alle attività MMCSS.

Per usare questo metodo, seguire questa procedura.

1. Creare la topologia.
2. Impostare gli attributi seguenti nei nodi di origine nella topologia.
   • MF_TOPONODE_WORKQUEUE_ID. Specifica un identificatore per la coda di lavoro. La sessione multimediale allocherà una nuova coda di lavoro.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Specifica la classe MMCSS.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Specifica l'identificatore dell'attività MMCSS (facoltativo). Se questo attributo non è impostato, MMCSS assegna un nuovo identificatore di attività.
3. Accodare la topologia chiamando IMFMediaSession::SetTopology.
4. Attendere l'evento MESessionTopologyStatus con lo stato MF_TOPOSTATUS_READY .
5. Chiamare BeginRegisterTopologyWorkQueuesWithMMCSS. Questo metodo registra tutte le code di lavoro della topologia con MMCSS.

Il metodo BeginRegisterTopologyWorkQueuesWithMMCSS è asincrono. Al termine dell'operazione, viene chiamato il metodo IMFAsyncCallback::Invoke dell'oggetto callback. All'interno del metodo di callback chiamare IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS per completare la richiesta asincrona. Al termine di questa operazione, la sessione multimediale registra automaticamente le code di lavoro per ogni nuova topologia accodata nella sessione multimediale. L'applicazione non deve chiamare di nuovo il metodo per le nuove topologie.

Per annullare la registrazione delle code di lavoro della topologia da MMCSS, chiamare IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS.

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

IMFWorkQueueServices