Метод 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

Указывает идентификатор пин-кода, который идентифицирует открываемую булавку. Если дескриптор фильтра драйвера miniport 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 для конкретного звука:

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

Требования

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

См. также раздел

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream