Share via

IMFRealTimeClientEx::RegisterThreadsEx-Methode (mfidl.h)

  • Artikel

Benachrichtigt das Objekt, seine Workerthreads beim Multimedia Class Scheduler Service (MMCSS) zu registrieren.

Syntax

HRESULT RegisterThreadsEx(
  [in, out] DWORD   *pdwTaskIndex,
  [in]      LPCWSTR wszClassName,
  [in]      LONG    lBasePriority
);

Parameter

[in, out] pdwTaskIndex

Der MMCSS-Aufgabenbezeichner. Wenn der Wert bei der Eingabe 0 ist, sollte das Objekt eine neue MCCSS-Taskgruppe erstellen. Siehe Hinweise.

[in] wszClassName

Der Name des MMCSS-Tasks.

[in] lBasePriority

Die Basispriorität des Threads.

Rückgabewert

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

Hinweise

Wenn das Objekt keine Workerthreads erstellt, sollte die Methode einfach S_OK zurückgeben und keine weiteren Aktionen ausführen.

Andernfalls sollte das Objekt die folgenden Schritte ausführen, wenn der Wert von *pdwTaskIndex bei der Eingabe 0 ist:

  1. Ein einzelner Workerthread ruft AvSetMmThreadCharacteristics auf, um einen neuen MMCSS-Aufgabenbezeichner zu erstellen. Speichern Sie diesen Wert.
  2. Alle zusätzlichen Workerthreads rufen AvSetMmThreadCharacteristics mithilfe des neuen Aufgabenbezeichners auf.
  3. Geben Sie den neuen Aufgabenbezeichner an den Aufrufer zurück, indem Sie gleich dem Aufgabenbezeichner festlegen *pdwTaskIndex .
Wenn der Wert von *pdwTaskIndex bei der Eingabe nichtzero ist, enthält der Parameter einen vorhandenen MMCSS-Aufgabenbezeichner. In diesem Fall sollten sich alle Workerthreads des Objekts für diese Aufgabe registrieren, indem AvSetMmThreadCharacteristics aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h

Weitere Informationen

IMFRealTimeClientEx

Verbesserungen bei Arbeitswarteschlange und Threading