IMFPMediaPlayer::CreateMediaItemFromObject 메서드(mfplay.h)

  • 아티클
중요 되지 않는. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다. 애플리케이션은 재생에 미디어 세션을 사용해야 합니다.
 

개체에서 미디어 항목을 만듭니다.

구문

HRESULT CreateMediaItemFromObject(
  [in]  IUnknown      *pIUnknownObj,
  [in]  BOOL          fSync,
  [in]  DWORD_PTR     dwUserData,
  [out] IMFPMediaItem **ppMediaItem
);

매개 변수

[in] pIUnknownObj

개체의 IUnknown 인터페이스에 대한 포인터입니다. 설명 부분을 참조하세요.

[in] fSync

TRUE이면 메서드가 완료될 때까지 차단됩니다. FALSE이면 메서드가 차단되지 않고 비동기적으로 완료됩니다.

[in] dwUserData

미디어 항목에 저장할 애플리케이션 정의 값입니다. 미디어 항목에서 이 값을 검색하려면 IMFPMediaItem::GetUserData를 호출합니다.

[out] ppMediaItem

IMFPMediaItem 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다. fSync가 TRUE이면 이 매개 변수가 유효한 포인터여야 합니다. bSync가 FALSE이면 이 매개 변수는 NULL이어야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 설명
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 인수가 잘못되었습니다.
MF_E_INVALIDREQUEST
 잘못된 요청입니다. 이 오류는 fSync 가 FALSE 이고 애플리케이션이 콜백 인터페이스를 제공하지 않은 경우에 발생할 수 있습니다. 설명 부분을 참조하세요.
MF_E_SHUTDOWN
 개체의 Shutdown 메서드가 호출되었습니다.

설명

pIUnknownObj 매개 변수는 다음 중 하나를 지정해야 합니다.

이 메서드는 재생을 위해 미디어 항목을 큐에 대기하지 않습니다. 재생을 위해 항목을 큐에 추가하려면 IMFPMediaPlayer::SetMediaItem을 호출합니다.

CreateMediaItemFromObject 메서드를 동기적으로 또는 비동기적으로 호출할 수 있습니다.

  • fSync가 TRUE이면 메서드가 동기적으로 완료됩니다. IMFPMediaItem 포인터는 ppMediaItem 매개 변수에 반환됩니다.
  • fSync가 FALSE이면 메서드가 비동기적으로 완료됩니다. 작업이 완료되면 애플리케이션의 IMFPMediaPlayerCallback::OnMediaPlayerEvent 콜백 메서드가 호출됩니다. 이벤트 유형이 MFP_EVENT_TYPE_MEDIAITEM_CREATED. 이벤트 데이터에는 새 미디어 항목에 대한 IMFPMediaItem 포인터가 포함됩니다.
콜백 인터페이스는 MFPCreateMediaPlayer 를 처음 호출하여 MFPlay 플레이어 개체를 만들 때 설정됩니다. 콜백 인터페이스를 제공하지 않는 경우 fSync 매개 변수는 TRUE여야 합니다. 그렇지 않으면 CreateMediaItemFromObject 는 MF_E_INVALIDREQUEST 반환합니다.

CreateMediaItemFromObject를 여러 번 비동기 호출하는 경우 동일한 순서로 완료할 수 없습니다. dwUserData 매개 변수를 사용하여 생성된 미디어 항목을 보류 중인 요청과 일치시킬 수 있습니다.

원본 구성

pIUnknownObj가 바이트 스트림을 가리키는 경우 다음 단계를 수행하여 미디어 원본을 구성할 수 있습니다.
  1. IMFPMediaPlayer 포인터에서 QueryInterface를 호출하여 IPropertyStore 인터페이스를 가져옵니다.
  2. IPropertyStore::SetValue를 호출하여 미디어 원본에 대한 속성을 설정합니다. 구성 속성 목록은 미디어 원본 구성을 참조하세요. 타사 미디어 원본은 사용자 지정 속성을 정의할 수 있습니다.
  3. CreateMediaItemFromObject 메서드를 호출하여 미디어 항목을 만듭니다.
pIUnknownObj가 미디어 원본을 가리키는 경우 원본을 만들 때 구성할 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfplay.h

참고 항목

IMFPMediaPlayer

오디오/비디오 재생에 MFPlay 사용