COutputQueue.COutputQueue-Konstruktor

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Konstruktormethode.

Syntax

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
);

Parameter

pInputPin

Zeiger auf die IPin-Schnittstelle des Eingabepins. Das -Objekt liefert Beispiele an diesen Pin.

Phr

Zeiger auf einen HRESULT-Rückgabecode . Legen Sie den Wert auf S_OK fest, bevor Sie diese Methode aufrufen. Bei der Rückgabe erhält phr einen Wert, der den Erfolg oder Fehler der Methode angibt.

bAuto

Flag, das angibt, ob das Objekt entscheidet, wann eine Warteschlange erstellt werden soll. True gibt an, dass das Objekt nur dann eine Warteschlange erstellt, wenn der Eingabenadel möglicherweise blockiert wird. Bei FALSE gibt der bQueue-Parameter an, ob eine Warteschlange erstellt werden soll.

bQueue

Wenn bAutoauf TRUE festgelegt ist, wird dieser Parameter ignoriert. Wenn bAutoauf FALSE festgelegt ist, gibt dieses Flag an, ob eine Warteschlange erstellt werden soll.

lBatchSize

Maximale Anzahl von Proben, die in einem Batch geliefert werden sollen.

bBatchExact

Flag, das angibt, ob genaue Batchgrößen verwendet werden sollen. Bei TRUE wartet das Objekt auf lBatchSize-Beispiele , bevor es sie an den Eingabenadel liefert. Wenn FALSE angegeben ist, liefert das Objekt Stichproben, sobald es sie empfängt.

lListSize

Cachegröße für die Warteschlange. Der Standardwert DEFAULTCACHE ist eine Konstante, die für die CBaseList-Klasse definiert ist.

dwPriority

Priorität des Threads, der Beispiele liefert.

Bemerkungen

Wenn bAutoTRUE ist, ruft das Objekt die IMemInputPin::ReceiveCanBlock-Methode auf dem Downstream-Pin auf. Wenn ReceiveCanBlock S_OK zurückgibt (d. h. die Pin blockiert möglicherweise IMemInputPin::Receive-Aufrufe ), erstellt das Objekt einen Thread zum Übermitteln von Beispielen. Andernfalls wird kein Thread erstellt.

Wenn bAutoauf FALSE festgelegt ist, bestimmt der Wert von bQueue , ob ein Thread erstellt werden soll.

Wenn das Objekt einen Thread erstellt, weist es das Threadhandle der COutputQueue:: m_hThread-Membervariable zu. Die Threadprozedur ist COutputQueue::InitialThreadProc, und der Threadparameter ist ein Zeiger darauf. Das -Objekt erstellt auch eine Warteschlange zum Speichern von Beispielen, die von der COutputQueue:: m_List-Membervariablen angegeben wird.

Anforderungen

Anforderung Wert
Header
Outputq.h (Streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

COutputQueue-Klasse