Méthode IMiniportWaveRT ::NewStream (portcls.h)
La NewStream méthode crée un nouveau instance d’un objet de flux WaveRT.
Syntaxe
NTSTATUS NewStream(
[out] PMINIPORTWAVERTSTREAM *Stream,
[in] PPORTWAVERTSTREAM PortStream,
[in] ULONG Pin,
[in] BOOLEAN Capture,
[in] PKSDATAFORMAT DataFormat
);
Paramètres
[out] Stream
Pointeur de sortie pour le nouveau flux. Ce paramètre pointe vers une variable de pointeur allouée par l’appelant, dans laquelle la NewStream méthode écrit un pointeur vers l’interface IMiniportWaveRTStream du nouvel objet stream. L’appelant spécifie un pointeur non NULL valide pour ce paramètre.
[in] PortStream
Pointeur vers IPortWaveRTStream.
[in] Pin
Spécifie un ID de broche qui identifie la broche à ouvrir. Si le descripteur de filtre du pilote de miniport WaveRT spécifie un total de n fabriques de broches sur le filtre, les valeurs valides pour le paramètre Pin sont comprises entre 0 et n-1. Pour plus d’informations sur les descripteurs de filtre, consultez la rubrique Fabriques de filtres .
[in] Capture
Spécifie une valeur booléenne qui indique s’il faut créer un flux de capture ou un flux de rendu. Ce paramètre est TRUE pour un flux de capture (entrée) et FALSE pour un flux de lecture (sortie).
[in] DataFormat
Pointeur vers une structure KSDATAFORMAT qui spécifie le format de données du nouveau flux. Pour plus d'informations, consultez la section Notes qui suit.
Valeur retournée
NewStream retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne une erreur appropriée status code.
Remarques
La NewStream méthode définit l’état initial du flux sur KSSTATE_STOP et sa position initiale sur 0. Pour plus d’informations, consultez les méthodes associées IMiniportWaveRTStream ::SetState et IMiniportWaveRTStream ::GetPosition.
Le paramètre DataFormat , qui spécifie le format de données du flux, pointe vers l’une des versions étendues spécifiques à l’audio suivantes de la structure KSDATAFORMAT :
Les paramètres Stream et PortStream suivent les conventions de comptage des références pour les objets COM.Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans les systèmes d’exploitation Windows Vista et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h |
| IRQL | Niveau passif. |
Voir aussi
IMiniportWaveRTStream
IMiniportWaveRTStream ::GetPosition