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