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 |