次の方法で共有


MediaFrameSourceController.GetPropertyByExtendedIdAsync メソッド

定義

カスタム ヘッダー情報を含む拡張 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 になります。つまり、より大きなバッファー サイズで呼び出しを再試行できます。

戻り値

正常に完了すると、操作の状態を含む MediaFrameSourceGetPropertyResult オブジェクトを返し、成功した場合は返されるプロパティ値を返す非同期操作。

属性

Windows の要件

デバイス ファミリ
Windows 10 Creators Update (10.0.15063.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v4.0 で導入)

注釈

一般的なデバイス プロパティは、 VideoDeviceController クラスのプロパティとして公開されます。 追加のプロパティは、 KSPROPERTYSETID_ExtendedCameraControl プロパティ セットで定義されます。 レガシ プロパティは、 PROPSETID_VIDCAP_CAMERACONTROL プロパティ セットで定義されます。 ID でカメラ プロパティにアクセスする例については、 拡張コントロールとメタデータのサンプルを参照してください。

適用対象