Metodo IMFExtendedCameraControl::GetCapabilities (mfidl.h)

Query per le funzionalità delle proprietà supportate dal dispositivo di acquisizione.

Sintassi

ULONGLONG GetCapabilities();

Valore restituito

Mapping ULONGLONG alle funzionalità delle proprietà. Le proprietà e le funzionalità supportate sono definite nel file di intestazione definito in ksmedia.h come costanti con la convenzione di denominazione KSCAMERA_EXTENDEDPROP_. Per altre informazioni, vedere KSPROPERTYSETID_ExtendedCameraControl.

Commenti

Verificare la presenza di una particolare funzionalità eseguendo un'operazione AND bit per bit con il valore restituito di questa funzione. Alcuni driver possono richiedere che l'anteprima del dispositivo fotocamera sia in uno stato in esecuzione prima di poter determinare quali controlli sono supportati. Se si verifica se un determinato controllo è supportato prima dell'esecuzione del flusso di anteprima, il controllo può essere descritto come non supportato (e quindi non disponibile) anche se è supportato dal dispositivo video.

Nell'esempio seguente viene illustrato il supporto delle query per la funzionalità di 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());
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	mfidl.h