다음을 통해 공유


IMiniportMidi::NewStream 메서드(portcls.h)

메서드는 NewStream 지정된 물리적 채널과 연결된 논리 스트림의 새 instance 만듭니다.

구문

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
);

매개 변수

[out] Stream

새 스트림에 대한 출력 포인터입니다. 이 매개 변수는 메서드가 스트림 개체의 IMiniportMidiStream 인터페이스에 대한 포인터를 작성하는 호출자 할당 포인터 변수를 가리킵니다.

[in, optional] OuterUnknown

스트림 개체를 집계해야 하는 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다. 집계가 필요하지 않은 경우 호출자는 이 매개 변수를 NULL로 지정합니다.

[in] PoolType

DMA 채널 개체에 대한 스토리지를 할당해야 하는 메모리 풀의 유형을 지정합니다. 이 매개 변수는 POOL_TYPE 열거형 값 중 하나로 설정됩니다.

[in] Pin

핀 ID를 지정합니다. 이 매개 변수는 열 핀을 식별합니다. MIDI miniport 개체의 IMiniport::GetDescription 메서드가 필터에서 총 n개의 핀 팩터리를 지정하는 필터 설명자를 출력하는 경우 유효한 핀 ID는 0에서 n-1까지의 범위에 있습니다.

[in] Capture

채널을 캡처 또는 재생에 사용할지 여부를 지정합니다. TRUE이면 캡처(입력) 채널입니다. FALSE이면 재생(출력) 채널입니다.

[in] DataFormat

이 스트림 instance 사용할 데이터 형식을 지정하는 KSDATAFORMAT 구조체에 대한 포인터입니다.

[out] ServiceGroup

서비스 그룹에 대한 출력 포인터입니다. 이 매개 변수는 메서드가 스트림의 서비스 그룹 개체의 IServiceGroup 인터페이스에 대한 포인터를 작성하는 호출자 할당 포인터 변수를 가리킵니다. 인터럽트 알림을 위해 등록되는 서비스 그룹입니다.

반환 값

NewStream 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.

설명

메서드는 NewStream 스트림의 초기 상태를 KSSTATE_STOP 설정합니다.

Stream, OuterUnknownServiceGroup 매개 변수는 COM 개체에 대한 참조 계산 규칙을 따릅니다.

요구 사항

요구 사항
대상 플랫폼 유니버설
헤더 portcls.h(Portcls.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

IMiniport::GetDescription

IMiniportMidi

IMiniportMidiStream

IServiceGroup

KSDATAFORMAT

POOL_TYPE