VideoDeviceController.GetDevicePropertyByExtendedId 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 la valeur de la propriété avec l’ID spécifié à partir du pilote de périphérique de capture, en utilisant un ID étendu avec des informations d’en-tête personnalisées et en spécifiant la taille maximale de mémoire tampon requise pour stocker le résultat. Vous pouvez utiliser cette méthode pour interroger des propriétés spécifiques à une caméra particulière.
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
Paramètres
- extendedPropertyId
-
Byte[]
byte[]
Tableau d’octets contenant les données d’identificateur étendu.
- 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 retourné est MaxPropertyValueSizeRequired. Si la valeur fournie est trop petite pour stocker le résultat de l’opération, l’objet Status retourné sera MaxPropertyValueSizeTooSmall, ce qui signifie que vous pouvez réessayer l’appel avec une plus grande taille de mémoire tampon.
Retours
Objet VideoDeviceControllerGetDevicePropertyResult contenant les status de l’opération et, en cas de réussite, la valeur de la 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.