IMiniportMidi::Metode NewStream (portcls.h)

Metode ini NewStream membuat instans baru dari aliran logis yang terkait dengan saluran fisik tertentu.

Sintaks

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

Penunjuk output untuk aliran baru. Parameter ini menunjuk ke variabel pointer yang dialokasikan penelepon tempat metode menulis pointer ke antarmuka IMiniportMidiStream objek stream.

[in, optional] OuterUnknown

Penunjuk ke antarmuka IUnknown objek yang perlu mengagregasi objek stream. Parameter ini bersifat opsional. Jika agregasi tidak diperlukan, pemanggil menentukan parameter ini sebagai NULL.

[in] PoolType

Menentukan jenis kumpulan memori tempat penyimpanan untuk objek saluran DMA harus dialokasikan. Parameter ini diatur ke salah satu nilai enumerasi POOL_TYPE .

[in] Pin

Menentukan ID pin. Parameter ini mengidentifikasi pin yang akan dibuka. Jika metode IMiniport::GetDescription objek midiport menghasilkan deskriptor filter yang menentukan total n pin pabrik pada filter, maka ID pin yang valid berada dalam rentang 0 hingga n-1.

[in] Capture

Menentukan apakah saluran akan digunakan untuk pengambilan atau untuk pemutaran. Jika TRUE, ini adalah saluran pengambilan (input). Jika FALSE, ini adalah saluran pemutaran (output).

[in] DataFormat

Penunjuk ke struktur KSDATAFORMAT yang menentukan format data yang akan digunakan untuk instans aliran ini.

[out] ServiceGroup

Penunjuk output untuk grup layanan. Parameter ini menunjuk ke variabel pointer yang dialokasikan penelepon tempat metode menulis pointer ke antarmuka IServiceGroup dari objek grup layanan aliran. Ini adalah grup layanan yang sedang didaftarkan untuk pemberitahuan interupsi.

Mengembalikan nilai

NewStream mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan yang sesuai.

Keterangan

Metode NewStream ini mengatur status awal aliran ke KSSTATE_STOP.

Parameter Stream, OuterUnknown, dan ServiceGroup mengikuti konvensi penghitungan referensi untuk objek COM.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header portcls.h (termasuk Portcls.h)
IRQL PASSIVE_LEVEL

Lihat juga

IMiniport::GetDescription

IMiniportMidi

IMiniportMidiStream

IServiceGroup

KSDATAFORMAT

POOL_TYPE