DirectShow DirectShow 레퍼런스 DirectShow base class base class 레퍼런스 CCmdQueue   [목차열람] [주소복사] [슬롯비우기]

CCmdQueue 클래스

CCmdQueue 클래스는,CDeferredCommand 개체의 큐, 및 큐에 넣어진 커멘드의 추가, 삭제, 상태 체크, 실행을 위한 멤버 함수를 제공하는 base class이다. CCmdQueue 개체는,IQueueCommand 메서드를 처리 하는 개체의 일부이다. 필터 그래프 매니저는,IQueueCommand 메서드를 처리 해, 애플리케이션이 필터 그래프에 대한 커멘드를 큐에 넣을 수가 있도록(듯이) 한다. IQueueCommand 인터페이스를 처리 하는 필터는, 이 클래스를 직접 사용한다. CDeferredCommand 개체를 사용하는 경우는, 이 클래스로부터 큐를 파생시키지 않으면 안 된다.

동기에게는, 엉성한 모드와 정확한 모드라고 하는 2 개의 모드가 있다. 엉성한 모드에서는, 애플리케이션은 지정된 시간까지 대기한 후, 커멘드를 실행한다. 정확한 모드에서는, 애플리케이션은, 그 시간에 표시하는 샘플에 대한 처리가 시작 될 때까지 대기한 후, 커멘드를 실행한다. 어느 쪽을 처리 할까는, 필터에 의해 정해진다. 필터 그래프 매니저는, 필터 그래프 매니저의 큐에 넣어지는 커멘드에 대해, 항상 엉성한 모드를 처리 한다.

엉성한 동기가 필요한 경우, 실행해야 할 커멘드가 큐에 넣어질 때까지 대기한 후, 커멘드를 실행할 수가 있다. 이것은,CCmdQueue::GetDueCommand 를 호출하는 것에 의해 실행할 수 있다. 복수의 항목을 대기하고 있는 경우는,CCmdQueue::GetDueHandle 으로부터 이벤트 핸들을 취득해, 신호 상태가 되면 CCmdQueue::GetDueCommand 를 호출한다. 스트림 타임 은,CCmdQueue::Run 멤버 함수와 CCmdQueue::EndRun 멤버 함수의 호출동안에서만 진행된다. 핸들이 설정되어 있어도, 커멘드의 준비가 되어 있다고 하는 보증은 없다. 이벤트가 신호 상태가 될 때마다, (타임 아웃을 0 으로 해) GetDueCommand 멤버 함수를 호출한다. 이것에 의해, 커멘드의 준비가 되지 않은 경우는, E_ABORT 를 돌려줄 수가 있다.

정확한 동기가 필요한 경우는,CCmdQueue::GetCommandDueFor 멤버 함수를 호출해, 처리하려고 하고 있는 샘플을 파라미터로서 건네준다. 이 경우, 다음의 항목이 반환된다.

• 스트림 타임시 또는 그 전에 실행해야 하는 스트림 타임 커멘드.
• 스트림 타임의 프레젠테이션시 또는 그 전에 실행해야 하는 프레젠테이션 타임 커멘드. 이것은,CCmdQueue::Run 및 CCmdQueue::EndRun 멤버 함수의 사이에서만 실시한다. 이 범위외의 경우, 스트림 타임부터 프레젠테이션 타임에의 맵핑이 인식되지 않는다.
• 현재 실행해야 하는 프레젠테이션 타임 커멘드.

포즈 모드시에 처리될 가능성이 있는 샘플에 대해 정확한 동기가 필요한 경우는, 스트림 타임 커멘드를 사용해야 한다.

모든 경우에 대해, 커멘드는 불려 갈까 삭제될 때까지 큐에 남는다. 이벤트 핸들의 설정 및 리셋은, 모두 이 큐 개체에 의해 관리된다.

프로텍트 데이터 멤버

멤버 함수

오버라이드(override) 가능한 멤버 함수