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

Article
03/04/2024

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

Partager via