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, OuterUnknown 및 ServiceGroup 매개 변수는 COM 개체에 대한 참조 계산 규칙을 따릅니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
헤더 | portcls.h(Portcls.h 포함) |
IRQL | PASSIVE_LEVEL |