Método CSourceSeeking.CheckCapabilities

O CheckCapabilities método consulta se o fluxo especificou recursos de busca. Esse método implementa o método IMediaSeeking::CheckCapabilities .

Sintaxe

HRESULT CheckCapabilities(
   DWORD *pCapabilities
);

parâmetros

Pcapabilities

Ponteiro para uma combinação bit a bit de um ou mais atributos AM_SEEKING_SEEKING_CAPABILITIES .

Valor retornado

Retorna um dos valores HRESULT listados na tabela a seguir.

Código de retorno	Descrição
S_FALSE	Nem todos os recursos em pCapabilities estão presentes.
S_OK	Todos os recursos em pCapabilities estão presentes.
E_POINTER	Argumento de ponteiro NULL.

Comentários

Conforme implementado, esse método verifica o valor de *pCapabilities em relação à variável de membro CSourceSeeking::m_dwSeekingCaps . No entanto, ele não define *pCapabilities igual a m_dwSeekingCaps, conforme descrito para o método IMediaSeeking::CheckCapabilities . Além disso, no caso em que nenhum dos recursos especificados está disponível, o método não retorna E_FAIL. Uma implementação mais completa seria a seguinte:

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

Requisitos

Requisito	Valor
parâmetro	Ctlutil.h (inclua Fluxos.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CSourceSeeking