COutputQueue.COutputQueue 建構函式
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
建構函式方法。
語法
COutputQueue(
IPin *pInputPin,
HRESULT *phr,
BOOL bAuto = TRUE,
BOOL bQueue = TRUE,
LONG lBatchSize = 1,
BOOL bBatchExact = FALSE,
LONG lListSize = DEFAULTCACHE,
DWORD dwPriority = THREAD_PRIORITY_NORMAL
);
參數
-
pInputPin
-
輸入針腳的 IPin 介面指標。 物件會將範例傳遞至這個釘選。
-
phr
-
HRESULT傳回碼的指標。 在呼叫此方法之前,請先將值設定為 S_OK。 傳回時, phr 會收到值,指出方法的成功或失敗。
-
bAuto
-
旗標,指定物件是否決定何時要建立佇列。 如果 為 TRUE,則物件只有在輸入針腳可能會封鎖時,才會建立佇列。 如果 為 FALSE, bQueue 參數會指定是否要建立佇列。
-
bQueue
-
如果 bAuto 為 TRUE,則會忽略此參數。 如果 bAuto 為 FALSE,此旗標會指定是否要建立佇列。
-
lBatchSize
-
一個批次中要傳遞的樣本數目上限。
-
bBatchExact
-
指定是否要使用確切批次大小的旗標。 如果 為 TRUE,物件會先等候 lBatchSize 樣本,再將它們傳遞至輸入針腳。 如果 為 FALSE,則物件會在接收樣本時提供樣本。
-
lListSize
-
佇列的快取大小。 預設值 DEFAULTCACHE 是針對 CBaseList 類別定義的常數。
-
dwPriority
-
提供範例的執行緒優先順序。
備註
如果 bAuto 為 TRUE,物件會在下游針腳上呼叫 IMemInputPin::ReceiveCanBlock 方法。 如果 ReceiveCanBlock 傳回S_OK (表示 pin 可能會在 IMemInputPin::Receive 呼叫) 封鎖,物件會建立執行緒來傳遞範例。 否則,它不會建立執行緒。
如果 bAuto 為 FALSE, bQueue 的值會判斷是否要建立執行緒。
如果物件建立執行緒,它會將執行緒控制碼指派給 COutputQueue::m_hThread 成員變數。 執行緒程式是 COutputQueue::InitialThreadProc,而 thread 參數是這個的指標。 物件也會建立佇列來保存範例,此佇列是由 COutputQueue::m_List 成員變數所指定。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|