Méthode IMFASFSplitter ::GetNextSample (wmcontainer.h)

  • Article

Récupère un exemple à partir du séparateur ASF (Advanced Systems Format) une fois les données analysées.

Syntaxe

HRESULT GetNextSample(
  [out] DWORD     *pdwStatusFlags,
  [out] WORD      *pwStreamNumber,
  [out] IMFSample **ppISample
);

Paramètres

[out] pdwStatusFlags

Reçoit l’une des valeurs suivantes.

Valeur Signification
ASF_STATUSFLAGS_INCOMPLETE
 D’autres exemples sont prêts à être récupérés. Appelez GetNextSample dans une boucle jusqu’à ce que le paramètre pdwStatusFlags reçoive la valeur zéro.
Zéro
 Aucun échantillon supplémentaire n’est prêt. Appelez IMFASFSplitter ::P arseData pour fournir plus de données d’entrée au séparateur.

[out] pwStreamNumber

Si la méthode retourne un exemple dans le paramètre ppISample , ce paramètre reçoit le numéro du flux auquel appartient l’exemple.

[out] ppISample

Reçoit un pointeur vers l’interface IMFSample de l’exemple analysé. L’appelant doit libérer l’interface. Si aucun échantillon n’est prêt, ce paramètre reçoit la valeur NULL.

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
MF_E_ASF_INVALIDDATA
 Les données ASF dans la mémoire tampon ne sont pas valides.
MF_E_ASF_MISSINGDATA
 Il existe une lacune dans les données ASF.

Remarques

Avant d’appeler cette méthode, appelez IMFASFSplitter ::P arseData pour fournir des données d’entrée au séparateur. Si l’entrée ne contient pas suffisamment de données pour un exemple complet, la méthode GetNextSample réussit, mais retourne NULL dans le paramètre ppISample .

Le séparateur ASF ignore les exemples pour les flux non sélectionnés. Pour sélectionner des flux, appelez IMFASFSplitter ::SelectStreams.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wmcontainer.h
Bibliothèque Mfuuid.lib

Voir aussi

Séparateur ASF

IMFASFSplitter