KSCAMERA_PROFILE_INFO-Struktur (ksmedia.h)

Die KSCAMERA_PROFILE_INFO-Struktur wird verwendet, um ein bestimmtes Profil eindeutig zu identifizieren.

Syntax

typedef struct _KSCAMERA_PROFILE_INFO {
  GUID                      ProfileId;
  UINT32                    Index;
  UINT32                    PinCount;
  PKSCAMERA_PROFILE_PININFO Pins;
} KSCAMERA_PROFILE_INFO, *PKSCAMERA_PROFILE_INFO;

Member

ProfileId

GUID, die eine eindeutige ID für das Profil darstellt. Diese GUID kann eine eindeutige, von IHV/OEM erstellte GUID sein, die ein benutzerdefiniertes Profil darstellt, oder eine vordefinierte GUID.

Dieses Feld darf nicht auf KSCAMERAPROFILE_Legacy festgelegt werden. Das Legacyprofil darf nicht vom Kameratreiber veröffentlicht werden. Die Legacyprofil-ID wird während der Aufnahme-Engine-/Medienaufnahmeinitialisierung an den Kameratreiber gesendet, wenn die Anwendung nicht angegeben hat, dass sie Profile unterstützen kann.

In solchen Fällen muss der Kameratreiber sein Verhalten dem Windows 8.1 Betriebsmodus rückgängig machen und nur die reduzierten Mengenmedientypen zusammen mit den entsprechenden KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORD und KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORD Funktionsbits, die angeben, ob der Kameratreiber in der Lage ist, die gleichzeitige Aufnahme/Foto- und/oder Aufzeichnungs-/Fotosequenz innerhalb des reduzierten Medientyps zu unterstützen.

Index

Jedes Profil innerhalb einer angegebenen ProfileId-Gruppe muss über einen eindeutigen Indexwert verfügen. Dadurch kann jedes Profil für ein Gerät eindeutig mit dem ProfileId-Index + identifiziert werden.

PinCount

Die Anzahl der KSCAMERA_PROFILE_PININFO Strukturen, auf die durch Pins verwiesen wird. Dieser Wert muss größer als 0 sein.

Pins

Ein Array von KSCAMERA_PROFILE_PININFO Strukturen, die die unterstützten Medientypen für jeden der Pins dieses Profils definieren. Dieses Feld darf nicht NULL sein.

Anforderungen

Anforderung	Wert
Header	ksmedia.h (include Ksmedia.h)