structure KSCAMERA_EXTENDEDPROP_HEADER (ksmedia.h)
La structure KSCAMERA_EXTENDEDPROP_HEADER est l’en-tête de charge utile d’une propriété de contrôle étendue.
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 propriété étendue. Cette valeur est définie sur 1.
PinId
ID d’épingle qui correspond à la propriété. Si PinId a la valeur (ULONG)-1, le contrôle s’applique au filtre. Dans le cas contraire, le pilote de la caméra doit acheminer ce contrôle vers la broche correspondante lors de la création de cette broche (ou s’il 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 au 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 des indicateurs de peuvent varier en fonction du contrôle.
Le bit d’ordre élevé des indicateurs de 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. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| d’en-tête | ksmedia.h (include Ksmedia.h) |