IMFVirtualCamera::Start 메서드(mfvirtualcamera.h)

가상 카메라를 만들고 등록합니다.

구문

HRESULT Start(
  IMFAsyncCallback *pCallback
);

매개 변수

pCallback

파이프라인이 호출자에게 가상 카메라의 상태를 알리는 데 사용할 IMFAsyncCallback 개체에 대한 선택적 포인터입니다. 제공된 경우 콜백은 IMFMediaEvent를 사용하여 호출될 수 있습니다. 호출되면 IMFMediaEvent::GetType 메서드는 MEExtendedType 또는 MEError를 반환합니다. MEExtendedType이 반환되면 IMFMediaEvent::GetExtendedType 메서드는 다음 이벤트 유형 중 하나를 반환할 수 있습니다.

확장 이벤트 유형	Description
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE	가상 카메라를 나타내는 사용자 지정 미디어 원본이 애플리케이션에 의해 초기화되었습니다.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START	가상 카메라의 사용자 지정 미디어 원본에 있는 스트림(또는 스트림)이 애플리케이션에서 시작되었습니다.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP	가상 카메라의 사용자 지정 미디어 원본에 있는 모든 스트림이 애플리케이션에 의해 중지되었습니다.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE	가상 카메라의 사용자 지정 미디어 원본이 초기화되지 않았습니다.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN	가상 카메라의 파이프라인이 종료되었습니다.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT	가상 카메라의 사용자 지정 미디어 원본에 의해 사용자 지정 이벤트가 생성되었습니다. IMFMediaEvent에 대한 스키마는 공급업체별로 다릅니다.

IMFVirtualCamera::Start가 성공적으로 반환된 후 언제든지 콜백이 호출될 수 있습니다.

반환 값

다음 값을 포함하지만 이에 국한되지 않는 HRESULT 값을 반환합니다.

오류 코드	설명
S_OK	성공
E_INVALIDARG	입력 매개 변수가 잘못되었습니다.

설명

Start 메서드를 성공적으로 호출할 때까지 IMFVirtualCamera는 가상 카메라 구성 정보를 나타내며 MFCreateVirtualCamera가 기존 가상 카메라를 다시 여는 경우가 아니면 기본 가상 카메라가 아직 존재하지 않습니다. Start가 성공적으로 호출되면 IMFVirtualCamera가 상속하는 IMFAttributes에는 새로 만든 가상 카메라의 기호 링크 이름인 MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK 포함됩니다.

MFCreateVirtualCamera가 이전 호출과 동일한 매개 변수를 사용하여 호출되는 경우 이미 IMFVirtualCamera::Start에 대한 성공적인 호출로 시작된 IMFVirtualCamera를 지정하면 결과 IMFVirtualCamera가 이미 유효한 상태이며 IMFVirtualCamera::Start에 대한 후속 호출을 사용하여 새 콜백을 등록할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 빌드 22000
머리글	mfvirtualcamera.h
라이브러리	mfsensorgroup.lib
DLL	mfsensorgroup.dll

추가 정보

IMFAsyncCallback

IMFMediaEvent

MFCreateVirtualCamera