MediaFrameSourceController.GetPropertyByExtendedIdAsync メソッド

定義

名前空間:

Windows.Media.Capture.Frames

カスタム ヘッダー情報を含む拡張 ID を使用し、結果の格納に必要な最大バッファー サイズを指定して、指定した ID を持つ プロパティの値を 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 プロパティ セットで定義されます。 ID でカメラ プロパティにアクセスする例については、 拡張コントロールとメタデータのサンプルを参照してください。