CAutoUsingOutputPin-Klasse

Die CAutoUsingOutputPin-Klasse erhält und gibt den Zugriff auf ein CDynamicOutputPin-Objekt frei.

CAutoUsingOutputPin verfügt über die folgenden Membertypen:

Öffentliche Methoden Beschreibung
CAutoUsingOutputPin Konstruktormethode. Erhält Zugriff auf den angegebenen Pin.
~CAutoUsingOutputPin Destruktormethode. Erhält Zugriff auf den angegebenen Pin.

Hinweise

Wenn bestimmte Methoden für CDynamicOutputPinaufgerufen werden, muss der Aufrufer Zugriff auf den Pin erhalten und diesen Zugriff dann wieder frei geben. Um Zugriff zu erhalten, verwendet der Aufrufer die CDynamicOutputPin::StartUsingOutputPin-Methode. Um den Zugriff frei zu geben, ruft er die CDynamicOutputPin::StopUsingOutputPin-Methode auf. Die CAutoUsingOutputPin-Klasse ist eine Hilfsklasse, die diese Aufgaben in ihren Konstruktor- und Destruktormethoden behandelt. Im folgenden Codebeispiel wird die Verwendung dieser Klasse veranschaulicht:

CDynamicOutputPin *pPin;
HRESULT hr = S_OK;  // Important! Initialize to S_OK.

// TODO: Obtain a pointer to the pin (not shown).

// Scope for lock.
{
    // Hold lock on pin.
    CAutoUsingOutputPin UsingPin(pPin, &hr)

    if (SUCCEEDED(hr)) 
    {

        // Safe to use the pin.
        hr = pPin->Deliver(pSample);

    }

} // Object goes out of scope here.

// No longer safe to use the pin.

Anforderungen

Anforderung Wert
Header
Amfilter.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandels-Builds);
Strmbasd.lib (Debugbuilds)

Siehe auch

Basisklassenreferenz