Freigeben über

IMFAsyncCallback::GetParameters-Methode (mfobjects.h)

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

Syntax

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

Die Parameter

[out] pdwFlags

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

Wert Bedeutung
Zero
 Der Rückruf dauert nicht lange, bis er abgeschlossen ist, hat aber keine spezifischen Einschränkungen für das System, das es aufruft. Der Rückruf benötigt in der Regel weniger als 30 Millisekunden, um den Vorgang abzuschließen.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 Der Rückruf führt sehr minimale Verarbeitung durch. Es dauert weniger als 1 Millisekunden bis zum Abschluss.

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 durchführt (weniger als 50 Mikrosekunden), und der einzige vom System aufgerufene Aufruf 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
 Rückruf antworten.

[out] pdwQueue

Empfängt den Bezeichner der Arbeitswarteschlange, für die der Rückruf verteilt 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 versucht wird, den Rückruf zu verteilen. (Siehe MFPutWorkItem.)

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL
 Nicht implementiert. Gehen Sie vom Standardverhalten aus.

Bemerkungen

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

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

Wenn Sie Standardwerte für beide Parameter verwenden möchten, 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 Komponenten des Windows Media Format 11 SDK 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 vom Oktober 2006 für Windows XP Media Center Edition) installiert.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Siehe auch

Asynchrone Rückrufmethoden

IMFAsyncCallback-

Arbeitswarteschlangen

  • Last updated on