Méthode IMiniportWaveRT ::NewStream (portcls.h)

Article
02/29/2024

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

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream ::GetPosition

IMiniportWaveRTStream ::SetState

IPortWaveRTStream

Partager via