IMiniportMidi::NewStream-Methode (portcls.h)

Artikel
02/26/2024

Die NewStream -Methode erstellt eine neue instance eines logischen Datenstroms, der einem angegebenen physischen Kanal zugeordnet ist.

Syntax

NTSTATUS NewStream(
  [out]          PMINIPORTMIDISTREAM *Stream,
  [in, optional] PUNKNOWN            OuterUnknown,
  [in]           POOL_TYPE           PoolType,
  [in]           ULONG               Pin,
  [in]           BOOLEAN             Capture,
  [in]           PKSDATAFORMAT       DataFormat,
  [out]          PSERVICEGROUP       *ServiceGroup
);

Parameter

[out] Stream

Ausgabezeiger für den neuen Stream. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die Methode einen Zeiger auf die IMiniportMidiStream-Schnittstelle des Streamobjekts schreibt.

[in, optional] OuterUnknown

Zeiger auf die IUnknown-Schnittstelle eines Objekts, das das Streamobjekt aggregieren muss. Dieser Parameter ist optional. Wenn die Aggregation nicht erforderlich ist, gibt der Aufrufer diesen Parameter als NULL an.

[in] PoolType

Gibt den Typ des Speicherpools an, aus dem der Speicher für das DMA-Kanalobjekt zugeordnet werden soll. Dieser Parameter ist auf einen der POOL_TYPE Enumerationswerte festgelegt.

[in] Pin

Gibt die Pin-ID an. Dieser Parameter identifiziert den Pin, der geöffnet werden soll. Wenn die IMiniport::GetDescription-Methode des MIDI-Miniportobjekts einen Filterdeskriptor ausgibt, der insgesamt n Pin-Fabriken für den Filter angibt, liegen gültige Pin-IDs im Bereich von 0 bis n-1.

[in] Capture

Gibt an, ob der Kanal für die Aufzeichnung oder für die Wiedergabe verwendet werden soll. Bei TRUE handelt es sich um einen Erfassungskanal (Eingabekanal). Bei FALSE handelt es sich um einen Wiedergabekanal (Ausgabekanal).

[in] DataFormat

Zeiger auf eine KSDATAFORMAT-Struktur, die das Datenformat angibt, das für diesen Stream instance verwendet werden soll.

[out] ServiceGroup

Ausgabezeiger für die Dienstgruppe. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die Methode einen Zeiger auf die IServiceGroup-Schnittstelle des Dienstgruppenobjekts des Streams schreibt. Dies ist die Dienstgruppe, die für Unterbrechungsbenachrichtigungen registriert wird.