KsPublishDeviceProfile-Funktion (ks.h)

Artikel
02/07/2025

Die KsPublishDeviceProfile-API wird aufgerufen, um Geräteprofilinformationen zu veröffentlichen.

Syntax

KSDDKAPI NTSTATUS KsPublishDeviceProfile(
  [in] PKSFILTERFACTORY       FilterFactory,
  [in] PKSDEVICE_PROFILE_INFO Profile
);

Parameter

[in] FilterFactory

Dies ist die gleiche KSFILTERFACTORY in der KsInitializeDeviceProfile-API verwendet.

[in] Profile

Dies ist ein Kameraprofil vom Typ KSDEVICE_PROFILE_INFO.

Rückgabewert

Kameraprofilinformationen werden nur der KSCATEGORY_VIDEO_CAMERA Schnittstellenkategorie zugeordnet. Jede Filterfactory, die ohne diese Schnittstellenkategorie erstellt wurde und versucht, ein Kameraprofil zu registrieren, führt dazu, dass diese API eine STATUS_INVALID_PARAMETERzurückgibt.

Bemerkungen

Diese API wird für jedes Profil, das der Kameratreiber unterstützt, wiederholt aufgerufen. Jeder Aufruf verfügt möglicherweise über unterschiedliche Parallelitäts- und Datenbereichsinformationen. Das ProfileId- Feld des KSCAMERA_PROFILE_INFO muss eindeutig sein. Wenn dieselbe ProfileId- verwendet wird und der Inhalt der Profilinformationen anders ist, überschreibt der nachfolgende Aufruf die früheren Profilinformationen.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ksmedia.h)
Library	Ks.lib

Freigeben über