VideoDeviceController.GetDevicePropertyById Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
-
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.