VideoDeviceController.GetDevicePropertyById 方法

定義

命名空間:

Windows.Media.Devices

使用具有自定義標頭資訊的標識碼，從擷取設備驅動器取得 屬性的值。 您可以使用這個方法來查詢特定相機特有的屬性。

public:
 virtual VideoDeviceControllerGetDevicePropertyResult ^ GetDevicePropertyById(Platform::String ^ propertyId, IReference<unsigned int> ^ maxPropertyValueSize) = GetDevicePropertyById;

VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyById(winrt::hstring const& propertyId, IReference<uint32_t> const& maxPropertyValueSize);

public VideoDeviceControllerGetDevicePropertyResult GetDevicePropertyById(string propertyId, System.Nullable<uint> maxPropertyValueSize);

function getDevicePropertyById(propertyId, maxPropertyValueSize)

Public Function GetDevicePropertyById (propertyId As String, maxPropertyValueSize As Nullable(Of UInteger)) As VideoDeviceControllerGetDevicePropertyResult

參數

propertyId

String

Platform::String

winrt::hstring

擷取值之屬性的標識碼。

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 屬性集中。 如需依標識符存取相機屬性的範例，請參閱 擴充控件和元數據範例。