IMiniportWaveRT::NewStream-Methode (portcls.h)

Artikel
03/01/2024

Die NewStream -Methode erstellt eine neue instance 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 Stream. Dieser Parameter verweist auf eine vom Aufrufer zugeordnete Zeigervariable, in die die NewStream Methode einen Zeiger auf die IMiniportWaveRTStream-Schnittstelle des neuen Streamobjekts schreibt. Der Aufrufer gibt einen gültigen Nicht-NULL-Zeiger für diesen Parameter an.

[in] PortStream

Zeiger auf IPortWaveRTStream.

[in] Pin

Gibt eine Pin-ID an, die die zu öffnende Pin identifiziert. Wenn der Filterdeskriptor des WaveRT-Miniporttreibers insgesamt n Pin-Fabriken für den Filter angibt, liegen die gültigen Werte für den Pin-Parameter im Bereich von 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 (Ausgabe).

[in] DataFormat

Zeiger 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 Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehler status Code zurück.

Hinweise

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

Der DataFormat-Parameter , 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
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Windows-Betriebssystemen.
Zielplattform	Universell
Header	portcls.h
IRQL	Passive Ebene.

Weitere Informationen

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream

Freigeben über