VideoDeviceController.GetDevicePropertyByExtendedId メソッド

定義

名前空間:

Windows.Media.Devices

カスタム ヘッダー情報を含む拡張 ID を使用し、結果を格納するために必要な最大バッファー サイズを指定して、キャプチャ デバイス ドライバーから指定された ID を持つ プロパティの値を取得します。 このメソッドを使用すると、特定のカメラに固有のプロパティに対してクエリを実行できます。

public:
 virtual VideoDeviceControllerGetDevicePropertyResult ^ GetDevicePropertyByExtendedId(Platform::Array <byte> ^ extendedPropertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetDevicePropertyByExtendedId;

VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(winrt::array_view <byte> const& extendedPropertyId, IReference<uint32_t> const& maxPropertyValueSize);

public VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyByExtendedId(byte[] extendedPropertyId, System.Nullable<uint> maxPropertyValueSize);

function getDevicePropertyByExtendedId(extendedPropertyId, maxPropertyValueSize)

Public Function GetDevicePropertyByExtendedId (extendedPropertyId As Byte(), maxPropertyValueSize As Nullable(Of UInteger)) As VideoDeviceControllerGetDevicePropertyResult

パラメーター

extendedPropertyId

Byte[]

byte[]

拡張識別子データを含むバイト配列。

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

操作の結果を格納するために割り当てる必要があるバッファーのサイズ。 ドライバーで、返されるプロパティのサイズを指定する必要がない場合は、この値を null に設定します。 サイズが必要で、値を指定しない場合、返される VideoDeviceControllerGetDevicePropertyResult オブジェクトの Status プロパティは MaxPropertyValueSizeRequired になります。 指定された値が小さすぎて操作の結果を格納できない場合、返される Status オブジェクトは MaxPropertyValueSizeTooSmall になります。つまり、より大きなバッファー サイズで呼び出しを再試行できます。

戻り値

VideoDeviceControllerGetDevicePropertyResult

操作の状態と、成功した場合に返されるプロパティ値を含む VideoDeviceControllerGetDevicePropertyResult オブジェクト。

Windows の要件

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

注釈

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