IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS 메서드(mfidl.h)

  • 아티클

토폴로지 작업 큐를 MMCSS(멀티미디어 클래스 스케줄러 서비스)에 등록합니다.

구문

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

매개 변수

[in] pCallback

콜백 개체의 IMFAsyncCallback 인터페이스에 대한 포인터입니다. 호출자는 이 인터페이스를 구현해야 합니다.

[in] pState

호출자가 정의한 상태 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 개체를 사용하여 상태 정보를 저장할 수 있습니다. 콜백이 호출될 때 개체가 호출자에게 반환됩니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

토폴로지의 각 원본 노드는 토폴로지의 한 분기를 정의합니다. 분기에는 해당 노드에서 데이터를 수신하는 모든 토폴로지 노드가 포함됩니다. 애플리케이션은 토폴로지의 각 분기를 자체 작업 큐에 할당한 다음 해당 작업 큐를 MMCSS 작업과 연결할 수 있습니다.

이 메서드를 사용하려면 다음 단계를 수행합니다.

  1. 토폴로지를 만듭니다.
  2. 토폴로지의 원본 노드에서 다음 특성을 설정합니다.
  3. IMFMediaSession::SetTopology를 호출하여 토폴로지를 큐에 추가합니다.
  4. MF_TOPOSTATUS_READY 상태MESessionTopologyStatus 이벤트를 기다립니다.
  5. BeginRegisterTopologyWorkQueuesWithMMCSS를 호출합니다. 이 메서드는 모든 토폴로지 작업 큐를 MMCSS에 등록합니다.
BeginRegisterTopologyWorkQueuesWithMMCSS 메서드는 비동기적입니다. 작업이 완료되면 콜백 개체의 IMFAsyncCallback::Invoke 메서드가 호출됩니다. 콜백 메서드 내에서 IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS 를 호출하여 비동기 요청을 완료합니다. 이 작업이 완료되면 미디어 세션은 미디어 세션에 큐에 대기 중인 모든 새 토폴로지의 작업 큐를 자동으로 등록합니다. 애플리케이션은 새 토폴로지의 경우 메서드를 다시 호출할 필요가 없습니다.

MMCSS에서 토폴로지 작업 큐의 등록을 취소하려면 IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

추가 정보

IMFWorkQueueServices