IMFAsyncCallback::GetParameters-Methode (mfobjects.h)

  • Artikel

Stellt Konfigurationsinformationen für den Verteilerthread für einen Rückruf bereit.

Syntax

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

Parameter

[out] pdwFlags

Empfängt ein Flag, das das Verhalten der IMFAsyncCallback::Invoke-Methode des Rückrufobjekts angibt. Die folgenden Werte werden definiert. Der Standardwert ist 0 (null).

Wert Bedeutung
Zero
 Der Rückruf dauert nicht lange, aber es gibt keine spezifischen Einschränkungen für die Aufrufe des Systems. Der Rückruf dauert in der Regel weniger als 30 Millisekunden.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 Der Rückruf führt eine sehr minimale Verarbeitung durch. Die Fertigstellung dauert weniger als 1 Millisekunde.

Der Rückruf muss aus einer der folgenden Arbeitswarteschlangen aufgerufen werden:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 Impliziert MFASYNC_FAST_IO_PROCESSING_CALLBACK mit der zusätzlichen Einschränkung, dass der Rückruf keine Verarbeitung ausführt (weniger als 50 Mikrosekunden), und der einzige Systemaufruf, den er ausführt, ist SetEvent.

Der Rückruf muss aus einer der folgenden Arbeitswarteschlangen aufgerufen werden:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 Blockieren des Rückrufs.
MFASYNC_REPLY_CALLBACK
 Antwortrückruf.

[out] pdwQueue

Empfängt den Bezeichner der Arbeitswarteschlange, für die der Rückruf versendet wird.

Dieser Wert kann eine der Standardmäßigen Media Foundation-Arbeitswarteschlangen oder eine von der Anwendung erstellte Arbeitswarteschlange angeben. Eine Liste der Standardmäßigen Media Foundation-Arbeitswarteschlangen finden Sie unter Arbeitswarteschlangenbezeichner. Um eine neue Arbeitswarteschlange zu erstellen, rufen Sie MFAllocateWorkQueue auf. Der Standardwert ist MFASYNC_CALLBACK_QUEUE_STANDARD.

Wenn die Arbeitswarteschlange nicht mit dem in pdwFlags zurückgegebenen Wert kompatibel ist, gibt die Media Foundation-Plattform MF_E_INVALID_WORKQUEUE zurück, wenn sie versucht, den Rückruf zu senden. (Siehe MFPutWorkItem.)

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL
 Nicht implementiert. Nehmen Sie das Standardverhalten an.

Hinweise

Die GetParameters-Methode gibt Informationen zum Rückruf zurück, sodass der verteilende Thread den Prozess optimieren kann, den er zum Aufrufen des Rückrufs verwendet.

Wenn die Methode einen anderen Wert als null im pdwFlags-Parameter zurückgibt, muss Ihre Invoke-Methode die hier beschriebenen Anforderungen erfüllen. Andernfalls kann der Rückruf die Pipeline verzögern.

Wenn Sie Standardwerte für beide Parameter wünschen, geben Sie E_NOTIMPL zurück. Die Standardwerte werden in den Parameterbeschreibungen auf dieser Seite angegeben.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

Asynchrone Rückrufmethoden

IMFAsyncCallback

Arbeitswarteschlangen