IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS-Methode (mfidl.h)

Registriert die Topologiearbeitswarteschlangen beim Multimedia Class Scheduler Service (MMCSS).

Syntax

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

Parameter

[in] pCallback

Ein Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren.

[in] pState

Ein Zeiger auf die IUnknown-Schnittstelle eines vom Aufrufer definierten Zustandsobjekts. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen zu enthalten. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Jeder Quellknoten in der Topologie definiert einen Branch der Topologie. Der Branch umfasst jeden Topologieknoten, der Daten von diesem Knoten empfängt. Eine Anwendung kann jedem Branch einer Topologie eine eigene Arbeitswarteschlange zuweisen und diese Arbeitswarteschlangen dann MMCSS-Aufgaben zuordnen.

Führen Sie die folgenden Schritte aus, um diese Methode zu verwenden.

1. Erstellen Sie die Topologie.
2. Legen Sie die folgenden Attribute auf den Quellknoten in der Topologie fest.
   • MF_TOPONODE_WORKQUEUE_ID. Gibt einen Bezeichner für die Arbeitswarteschlange an. Die Mediensitzung ordnet eine neue Arbeitswarteschlange zu.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Gibt die MMCSS-Klasse an.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Gibt den MMCSS-Taskbezeichner an (optional). Wenn dieses Attribut nicht festgelegt ist, weist MMCSS einen neuen Aufgabenbezeichner zu.
3. Stellen Sie die Topologie in eine Warteschlange, indem Sie IMFMediaSession::SetTopology aufrufen.
4. Warten Sie auf das MESessionTopologyStatus-Ereignis mit dem MF_TOPOSTATUS_READY status.
5. Rufen Sie BeginRegisterTopologyWorkQueuesWithMMCSS auf. Diese Methode registriert alle Topologiearbeitswarteschlangen bei MMCSS.

Die BeginRegisterTopologyWorkQueuesWithMMCSS-Methode ist asynchron. Nach Abschluss des Vorgangs wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Rufen Sie in der Rückrufmethode IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS auf, um die asynchrone Anforderung abzuschließen. Nach Abschluss dieses Vorgangs registriert die Mediensitzung automatisch die Arbeitswarteschlangen für jede neue Topologie, die sich in der Mediensitzung in der Warteschlange befindet. Die Anwendung muss die -Methode für neue Topologien nicht erneut aufrufen.

Um die Registrierung der Topologiearbeitswarteschlangen in MMCSS aufzuheben, rufen Sie IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFWorkQueueServices