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

Requêtes sur les fonctionnalités de propriété prises en charge par l’appareil de capture.

Syntaxe

ULONGLONG GetCapabilities();

Valeur de retour

Un mappage ULONGLONG aux fonctionnalités de propriété. Les propriétés et fonctionnalités prises en charge sont définies dans le fichier d’en-tête défini dans ksmedia.h en tant que constantes avec la convention d’affectation de noms KSCAMERA_EXTENDEDPROP_. Pour plus d’informations, consultez KSPROPERTYSETID_ExtendedCameraControl.

Remarques

Vérifiez la présence d’une fonctionnalité particulière en effectuant une opération AND au niveau du bit avec la valeur de retour de cette fonction. Certains pilotes peuvent exiger que l’aperçu de l’appareil photo soit en cours d’exécution avant de pouvoir déterminer les contrôles pris en charge. Si vous case activée si un certain contrôle est pris en charge avant l’exécution du flux d’aperçu, le contrôle peut être décrit comme non pris en charge (et donc indisponible), même s’il est pris en charge par le périphérique vidéo.

L’exemple suivant illustre l’interrogation de la prise en charge de la fonctionnalité 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());
    }
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	mfidl.h