Méthode IMFAsyncCallback ::GetParameters (mfobjects.h)

  • Article

Fournit des informations de configuration au thread de distribution d’un rappel.

Syntaxe

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

Paramètres

[out] pdwFlags

Reçoit un indicateur indiquant le comportement de la méthode IMFAsyncCallback ::Invoke de l’objet de rappel. Les valeurs suivantes sont définies. La valeur par défaut est zéro.

Valeur Signification
Zéro
 Le rappel ne prend pas beaucoup de temps, mais n’a pas de restrictions spécifiques sur les appels système qu’il effectue. Le rappel prend généralement moins de 30 millisecondes.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 Le rappel effectue un traitement très minimal. L’opération prend moins de 1 milliseconde.

Le rappel doit être appelé à partir de l’une des files d’attente de travail suivantes :

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 Implique MFASYNC_FAST_IO_PROCESSING_CALLBACK, avec la restriction supplémentaire que le rappel ne traite pas (moins de 50 microsecondes), et que le seul appel système qu’il effectue est SetEvent.

Le rappel doit être appelé à partir de l’une des files d’attente de travail suivantes :

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 Rappel bloquant.
MFASYNC_REPLY_CALLBACK
 Rappel de réponse.

[out] pdwQueue

Reçoit l’identificateur de la file d’attente de travail sur laquelle le rappel est distribué.

Cette valeur peut spécifier l’une des files d’attente de travail Media Foundation standard ou une file d’attente de travail créée par l’application. Pour obtenir la liste des files d’attente de travail Media Foundation standard, consultez Identificateurs de file d’attente de travail. Pour créer une file d’attente de travail, appelez MFAllocateWorkQueue. La valeur par défaut est MFASYNC_CALLBACK_QUEUE_STANDARD.

Si la file d’attente de travail n’est pas compatible avec la valeur retournée dans pdwFlags, la plateforme Media Foundation retourne MF_E_INVALID_WORKQUEUE lorsqu’elle tente de distribuer le rappel. (Voir MFPutWorkItem.)

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
E_NOTIMPL
 Non implémenté. Supposez le comportement par défaut.

Remarques

La méthode GetParameters retourne des informations sur le rappel afin que le thread de distribution puisse optimiser le processus qu’il utilise pour appeler le rappel.

Si la méthode retourne une valeur autre que zéro dans le paramètre pdwFlags , votre méthode Invoke doit répondre aux exigences décrites ici. Sinon, le rappel peut retarder le pipeline.

Si vous souhaitez des valeurs par défaut pour les deux paramètres, retournez E_NOTIMPL. Les valeurs par défaut sont fournies dans les descriptions des paramètres de cette page.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfobjects.h (include Mfidl.h)
Bibliothèque Mfuuid.lib

Voir aussi

Méthodes de rappel asynchrones

IMFAsyncCallback

Files d’attente de travail