Partager via


KSCAMERA_EXTENDEDPROP_HEADER structure (ksmedia.h)

La structure KSCAMERA_EXTENDEDPROP_HEADER est l’en-tête de charge utile d’une propriété de contrôle étendu.

Syntaxe

typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
  ULONG     Version;
  ULONG     PinId;
  ULONG     Size;
  ULONG     Result;
  ULONGLONG Flags;
  ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;

Membres

Version

Numéro de version de la propriété étendue. Cette valeur est définie sur 1.

PinId

ID d’épingle qui correspond à la propriété . Si PinId est défini sur (ULONG)-1, le contrôle s’applique au filtre. Sinon, le pilote de la caméra doit acheminer ce contrôle vers l’épingle correspondante lors de la création de cette broche (ou si elle est déjà disponible).

Size

Taille totale, en octets de la charge utile entière. Cela inclut la structure KSCAMERA_EXTENDEDPROP_HEADER et les données de charge utile spécifiques de contrôle suivantes.

Result

Pour une opération définie, il s’agit de 0. Pour les requêtes, Result contient tout code d’échec fourni par le pilote pour l’opération de contrôle la plus récente.

Flags

Les paramètres dans Indicateurs peuvent varier en fonction du contrôle.

Le bit d’ordre élevé de la valeur Flags est réservé. Ce bit sert d’indicateur d’annulation et est défini comme KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION. Cet indicateur n’est significatif que pour les contrôles asynchrones.

Capability

Ce membre est en lecture seule et indique les fonctionnalités standard du contrôle.

Les fonctionnalités suivantes sont définies.

Valeur Description
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL Le contrôle prend en charge l’opération asynchrone.
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE S’applique uniquement aux contrôles asynchrones. Cet indicateur marque l’opération de contrôle comme annulable. Si un contrôle synchrone définit cet indicateur, il est marqué comme non valide et n’est pas exposé aux applications de niveau supérieur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1
Serveur minimal pris en charge Windows Server 2012 R2
En-tête ksmedia.h (incluez Ksmedia.h)

Voir aussi

KSCAMERA_EXTENDEDPROP_VALUE