Метод IMiniportWaveRT::NewStream (portcls.h)

Метод NewStream создает новый экземпляр объекта потока WaveRT.

Синтаксис

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

Параметры

[out] Stream

Указатель вывода для нового потока. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую NewStream метод записывает указатель на интерфейс IMiniportWaveRTStream нового объекта потока. Вызывающий объект задает допустимый указатель, отличный отNULL для этого параметра.

[in] PortStream

Указатель на IPortWaveRTStream.

[in] Pin

Указывает идентификатор пин-кода, определяющий открытый пин-код. Если дескриптор фильтра минипорта WaveRT указывает общее количество n пин-фабрик в фильтре, допустимые значения для параметра Pin находятся в диапазоне от 0 до n-1. Дополнительные сведения о дескрипторах фильтров см. в разделе "Фабрики фильтров".

[in] Capture

Указывает логическое значение, указывающее, следует ли создавать поток записи или поток отрисовки. Этот параметр имеет значение TRUE для потока записи (входных данных) и FALSE для потока воспроизведения (вывода).

[in] DataFormat

Указатель на структуру KSDATAFORMAT , указывающую формат данных нового потока. Дополнительные сведения см. в следующем разделе "Примечания".

Возвращаемое значение

NewStream возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код состояния ошибки.

Замечания

Метод NewStream задает начальное состояние потока для KSSTATE_STOP , а начальное положение — 0. Дополнительные сведения см. в связанных методах IMiniportWaveRTStream::SetState и IMiniportWaveRTStream::GetPosition.

Параметр DataFormat , указывающий формат данных потока, указывает на одну из следующих расширенных версий структуры KSDATAFORMAT:

• KSDATAFORMAT_WAVEFORMATEX

• KSDATAFORMAT_DSOUND

Параметры Stream и PortStream соответствуют соглашениям о подсчете ссылок для объектов COM.

Требования

Требование	Ценность
Минимально поддерживаемый клиент	Доступно в операционных системах Windows Vista и более поздних версий.
целевая платформа	универсальный
Заголовок	portcls.h
IRQL	Пассивный уровень.

См. также

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream