IMXF::SetState 메서드(dmusicks.h)

SetState 메서드는 MIDI 변환 인터페이스의 상태를 설정하는 데 사용됩니다.

구문

NTSTATUS SetState(
  KSSTATE State
);

매개 변수

State

필터 그래프를 설정할 상태를 지정합니다. 이 매개 변수는 KSSTATE 열거형 값입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

이 메서드는 호출이 성공한 경우 STATUS_SUCCESS 포함하는 NTSTATUS를 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.

설명

오디오 필터 그래프의 경우 4개의 KSSTATE 열거형 값은 다음과 같이 해석됩니다.

값	시스템 상태
KSSTATE_RUN	모든 것이 정상적으로 실행되고 작동합니다. 이 상태에서는 IMXF 인터페이스가 활성화되고 평소와 같이 메시지를 전달합니다.
KSSTATE_ACQUIRE	이는 KSSTATE_RUN KSSTATE_STOP 간의 전환을 관리하는 데 도움이 되는 전환 상태입니다. 이 상태에서는 필터 그래프에서 메시지를 다운스트림으로 전달할 수 없습니다.
KSSTATE_PAUSE	이는 KSSTATE_RUN KSSTATE_STOP 간의 전환을 관리하는 데 도움이 되는 전환 상태입니다.
KSSTATE_STOP	모든 항목이 현재 필터 그래프에서 중지됩니다.

미니포트 드라이버의 동작은 필터 그래프의 상태에 따라 달라집니다. 이 동작은 렌더링(출력) 및 캡처(입력)에 따라 다릅니다.

출력 쪽에서 현재 상태가 KSSTATE_RUN 이외의 상태인 경우 IMXF 인터페이스는 데이터를 유지하고 하드웨어에 전달하지 않아야 합니다. 현재 상태가 KSTATE_STOP 경우 미니포트 드라이버는 할당자에 해당 데이터를 전달하여 제공된 모든 데이터를 삭제해야 합니다.

입력 쪽에서 입력 스트림이 KSSTATE_RUN 또는 KSSTATE_PAUSE 있는 경우 미니포트 드라이버가 할당자로부터 메시지를 가져와 캡처 싱크로 업스트림 보내는 것이 합법적입니다. 상태가 KSSTATE_STOP 또는 KSSTATE_ACQUIRE 하드웨어가 데이터를 생성하려고 하는 경우 해당 데이터를 버려야 합니다.

요구 사항

요구 사항	값
헤더	dmusicks.h
IRQL	PASSIVE_LEVEL

추가 정보

IMXF