Compartilhar via

Método IMFExtendedCameraControl::GetCapabilities (mfidl.h)

  • Artigo

Consultas para recursos de propriedade compatíveis com o dispositivo de captura.

Sintaxe

ULONGLONG GetCapabilities();

Retornar valor

Um mapeamento ULONGLONG para recursos de propriedade. As propriedades e os recursos com suporte são definidos no arquivo de cabeçalho definido em ksmedia.h como constantes com a convenção de nomenclatura KSCAMERA_EXTENDEDPROP_. Para obter mais informações, consulte KSPROPERTYSETID_ExtendedCameraControl.

Comentários

Verifique a presença de uma funcionalidade específica executando uma operação AND bit a bit com o valor retornado dessa função. Alguns drivers podem exigir que a visualização do dispositivo de câmera esteja em um estado de execução antes de poder determinar quais controles têm suporte. Se você marcar se um determinado controle tem suporte antes da execução do fluxo de visualização, o controle pode ser descrito como sem suporte (e, portanto, indisponível), mesmo que tenha suporte do dispositivo de vídeo.

O exemplo a seguir demonstra o suporte à consulta para a funcionalidade de KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON .

if (FAILED(m_cameraController->GetExtendedCameraControl(MF_CAPTURE_ENGINE_MEDIASOURCE,
    KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE,
    cameraControl.put())))
{
    // Return false to indicate that the Torch Mode control is not available.
    return false;
}

ULONGLONG capabilities = cameraControl->GetCapabilities();

// Check if the torch can be turned on.
if (capabilities & KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON)
{
    // Check if the torch is off.
    if ((cameraControl->GetFlags() & KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON) == 0)
    {
        // Torch is off. Tell the camera to turn it on.
        check_hresult(cameraControl->SetFlags(KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON));
        // Write the changed settings to the driver.
        check_hresult(cameraControl->CommitSettings());
    }
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho mfidl.h