Partager via


VideoDeviceController.GetDevicePropertyById Méthode

Définition

Obtient une valeur de la propriété du pilote de périphérique de capture avec l’ID avec des informations d’en-tête personnalisées. Vous pouvez utiliser cette méthode pour interroger des propriétés spécifiques à une caméra particulière.

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

Paramètres

propertyId
String

Platform::String

winrt::hstring

Identificateur de la propriété pour laquelle la valeur est récupérée.

maxPropertyValueSize

IReference<UInt32>

Nullable<UInt32>

Windows.Foundation.IReference

IReference<uint32_t>

Taille de la mémoire tampon qui doit être allouée pour stocker le résultat de l’opération. Si le pilote n’exige pas qu’une taille soit spécifiée pour la propriété retournée, définissez cette valeur sur null. Si la taille est requise et que vous ne fournissez pas de valeur, la propriété Status de l’objet VideoDeviceControllerGetDevicePropertyResult renvoyé est MaxPropertyValueSizeRequired. Si la valeur fournie est trop petite pour stocker le résultat de l’opération, l’objet Status retourné est MaxPropertyValueSizeTooSmall, ce qui signifie que vous pouvez réessayer l’appel avec une plus grande taille de mémoire tampon.

Retours

Objet VideoDeviceControllerGetDevicePropertyResult contenant le status de l’opération et, en cas de réussite, la valeur de propriété retournée.

Configuration requise pour Windows

Famille d’appareils
Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Remarques

Les propriétés d’appareil courantes sont exposées en tant que propriétés de la classe VideoDeviceController . Des propriétés supplémentaires sont définies dans le jeu de propriétés KSPROPERTYSETID_ExtendedCameraControl . Les propriétés héritées sont définies dans le jeu de propriétés PROPSETID_VIDCAP_CAMERACONTROL . Pour obtenir un exemple d’accès aux propriétés de l’appareil photo par ID, consultez l’exemple Contrôle étendu et métadonnées.

S’applique à