MediaFrameSourceController.GetPropertyByExtendedIdAsync 方法

定義

命名空間:

Windows.Media.Capture.Frames

以異步方式從 MediaFrameSource 取得具有指定標識碼的屬性值，使用具有自定義標頭資訊的擴充標識符，以及指定儲存結果所需的緩衝區大小上限。

public:
 virtual IAsyncOperation<MediaFrameSourceGetPropertyResult ^> ^ GetPropertyByExtendedIdAsync(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetPropertyByExtendedIdAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<MediaFrameSourceGetPropertyResult> GetPropertyByExtendedIdAsync(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);

function getPropertyByExtendedIdAsync(extendedPropertyId, maxPropertyValueSize)

Public Function GetPropertyByExtendedIdAsync (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As IAsyncOperation(Of MediaFrameSourceGetPropertyResult)

參數

extendedPropertyId

Byte[]

byte[]

包含擴充標識碼數據的位元組數位。

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

應該配置來儲存作業結果的緩衝區大小。 如果驅動程式不需要為傳回的屬性指定大小，請將此值設定為 null。 如果需要大小，而且您未提供值，則傳回之 VideoDeviceControllerGetDevicePropertyResult 物件的 Status 屬性會是 MaxPropertyValueSizeRequired。 如果所提供的值太小而無法儲存作業的結果，傳回的 Status 物件會是 MaxPropertyValueSizeTooSmall，這表示您可以使用較大的緩衝區大小重試呼叫。

傳回

IAsyncOperation<MediaFrameSourceGetPropertyResult>

成功完成時，異步操作會傳回包含作業狀態的 MediaFrameSourceGetPropertyResult 物件，如果成功，則會傳回屬性值。

屬性

RemoteAsyncAttribute

Windows 需求

裝置系列	Windows 10 Creators Update (已於 10.0.15063.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v4.0 引進)

備註

常見的裝置屬性會公開為 VideoDeviceController 類別的屬性。 其他屬性定義於 KSPROPERTYSETID_ExtendedCameraControl 屬性集中。 舊版屬性定義於 PROPSETID_VIDCAP_CAMERACONTROL 屬性集中。 如需依標識符存取相機屬性的範例，請參閱 擴充控件和元數據範例。