IMFExtendedCameraControl：：GetCapabilities 方法 (mfidl.h)

查詢擷取裝置所支援的屬性功能。

Syntax

ULONGLONG GetCapabilities();

傳回值

ULONGLONG 對應至屬性功能。 支援的屬性和功能定義在 ksmedia.h 中定義的頭檔中，以命名慣例 KSCAMERA_EXTENDEDPROP_常數。 如需詳細資訊，請參閱 KSPROPERTYSETID_ExtendedCameraControl。

備註

使用這個函式的傳回值執行位 AND 作業，以確認特定功能是否存在。 有些驅動程式可能需要相機裝置預覽處於執行中狀態，才能判斷支援的控件。 如果您在預覽串流執行之前檢查是否支援特定控件，控件可能會描述為不支援的 (，因此即使影片裝置支援該控件，仍無法使用) 。

下列範例示範 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());
    }
}

規格需求

需求	值
最低支援的用戶端	Windows 10 組建 20348
最低支援的伺服器	Windows 10 組建 20348
標頭	mfidl.h