Partager via


VideoDeviceController.GetDevicePropertyByExtendedId Méthode

Définition

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

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 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.

S’applique à