Compartir a través de

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

  • Artículo

Consultas para funcionalidades de propiedad compatibles con el dispositivo de captura.

Sintaxis

ULONGLONG GetCapabilities();

Valor devuelto

Asignación de ULONGLONG a las funcionalidades de propiedad. Las propiedades y funcionalidades admitidas se definen en el archivo de encabezado definido en ksmedia.h como constantes con la convención de nomenclatura KSCAMERA_EXTENDEDPROP_. Para obtener más información, consulte KSPROPERTYSETID_ExtendedCameraControl.

Comentarios

Compruebe la presencia de una funcionalidad determinada realizando una operación AND bit a bit con el valor devuelto de esta función. Algunos controladores pueden requerir que la vista previa del dispositivo de cámara esté en estado de ejecución antes de poder determinar qué controles se admiten. Si comprueba si se admite un control determinado antes de que se ejecute la secuencia de vista previa, el control puede describirse como no compatible (y, por tanto, no disponible), aunque sea compatible con el dispositivo de vídeo.

En el ejemplo siguiente se muestra la compatibilidad con la consulta de la funcionalidad 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 Value
Cliente mínimo compatible compilación 20348 de Windows 10
Servidor mínimo compatible compilación 20348 de Windows 10
Encabezado mfidl.h