IMiniportWaveRT::NewStream-Methode (portcls.h)

Artikel
02/07/2025

Die NewStream-Methode erstellt eine neue Instanz eines WaveRT-Streamobjekts.

Syntax

NTSTATUS NewStream(
  [out] PMINIPORTWAVERTSTREAM *Stream,
  [in]  PPORTWAVERTSTREAM     PortStream,
  [in]  ULONG                 Pin,
  [in]  BOOLEAN               Capture,
  [in]  PKSDATAFORMAT         DataFormat
);

Parameter

[out] Stream

Ausgabezeiger für den neuen Datenstrom. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die NewStream-Methode einen Zeiger auf die IMiniportWaveRTStream Schnittstelle des neuen Datenstromobjekts schreibt. Der Aufrufer gibt einen gültigen, nichtNULL- Zeiger für diesen Parameter an.

[in] PortStream

Zeiger auf die IPortWaveRTStream-.

[in] Pin

Gibt eine Pin-ID an, die den zu öffnenden Pin identifiziert. Wenn der Filterdeskriptor des WaveRT-Miniporttreibers eine Summe von n Pin-Fabriken für den Filter angibt, befinden sich gültige Werte für den Parameter Pin im Bereich 0 bis n-1. Weitere Informationen zu Filterdeskriptoren finden Sie im Thema Filterfabriken.

[in] Capture

Gibt einen booleschen Wert an, der angibt, ob ein Aufnahmedatenstrom oder ein Renderdatenstrom erstellt werden soll. Dieser Parameter ist TRUE für einen Aufnahmedatenstrom (Eingabedatenstrom) und FALSE- für einen Wiedergabedatenstrom (Ausgabedatenstrom).

[in] DataFormat

Zeigen Sie auf eine KSDATAFORMAT- Struktur, die das Datenformat des neuen Datenstroms angibt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

NewStream gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls gibt die Methode einen entsprechenden Fehlerstatuscode zurück.

Bemerkungen

Die NewStream-Methode legt den Anfangszustand des Datenstroms auf KSSTATE_STOP und seine Anfangsposition auf 0 fest. Weitere Informationen finden Sie unter verwandten Methoden IMiniportWaveRTStream::SetState und IMiniportWaveRTStream::GetPosition.

Der parameter DataFormat, der das Datenformat des Datenstroms angibt, verweist auf eine der folgenden audiospezifischen erweiterten Versionen der KSDATAFORMAT-Struktur:

Die parameter Stream und PortStream folgen den Referenzzählungskonventionen für COM-Objekte.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Windows-Betriebssystemen.
Zielplattform-	Universal
Header-	portcls.h
IRQL-	Passive Ebene.

Siehe auch

IMiniportWaveRT-

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream-

Freigeben über