IMFExtendedCameraControl::GetCapabilities-Methode (mfidl.h)

  • Artikel

Abfragen von Eigenschaftenfunktionen, die vom Erfassungsgerät unterstützt werden.

Syntax

ULONGLONG GetCapabilities();

Rückgabewert

Eine ULONGLONG-Zuordnung zu Eigenschaftenfunktionen. Unterstützte Eigenschaften und Funktionen werden in der in ksmedia.h definierten Headerdatei als Konstanten mit der Namenskonvention KSCAMERA_EXTENDEDPROP_ definiert. Weitere Informationen finden Sie unter KSPROPERTYSETID_ExtendedCameraControl.

Hinweise

Überprüfen Sie das Vorhandensein einer bestimmten Funktion, indem Sie einen bitweisen AND-Vorgang mit dem Rückgabewert dieser Funktion ausführen. Einige Treiber erfordern möglicherweise, dass sich die Vorschauversion des Kamerageräts in einem aktiven Zustand befindet, bevor ermittelt werden kann, welche Steuerelemente unterstützt werden. Wenn Sie überprüfen, ob ein bestimmtes Steuerelement unterstützt wird, bevor der Vorschaudatenstrom ausgeführt wird, wird das Steuerelement möglicherweise als nicht unterstützt (und somit nicht verfügbar) beschrieben, obwohl es vom Videogerät unterstützt wird.

Im folgenden Beispiel wird die Abfrageunterstützung für die KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON-Funktion veranschaulicht.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile mfidl.h