Metodo CSourceSeeking.CheckCapabilities

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il CheckCapabilities metodo esegue una query che indica se il flusso ha specificato le funzionalità di ricerca. Questo metodo implementa il metodo IMediaSeeking::CheckCapabilities .

Sintassi

HRESULT CheckCapabilities(
   DWORD *pCapabilities
);

Parametri

pCapabilities

Puntatore a una combinazione bit per bit di uno o più attributi AM_SEEKING_SEEKING_CAPABILITIES .

Valore restituito

Restituisce uno dei valori HRESULT elencati nella tabella seguente.

Commenti

Come implementato, questo metodo controlla il valore di *pCapabilities rispetto alla variabile membro CSourceSeeking::m_dwSeekingCaps . Tuttavia, non imposta *pCapabilities uguale a m_dwSeekingCaps, come descritto per il metodo IMediaSeeking::CheckCapabilities . Inoltre, nel caso in cui nessuna delle funzionalità specificate sia disponibile, il metodo non restituisce E_FAIL. Un'implementazione più completa sarà la seguente:

STDMETHODIMP CheckCapabilities(DWORD *pCapabilities)
{
    CheckPointer(pCapabilities, E_POINTER)
;
    DWORD dwCaps;
    HRESULT hr = GetCapabilities(&dwCaps);
    if (SUCCEEDED(hr))
    {
        dwCaps &= *pCapabilities;
        if (dwCaps)
        {
            hr =  (dwCaps == *pCapabilities ? S_OK : S_FALSE );
        }
        else 
        {
            hr = E_FAIL;
        }
        *pCapabilities = dwCaps;
    }
    else 
    {
        *pCapabilities = 0;
    }
    return hr;
}

Requisiti

Vedi anche

Classe CSourceSeeking