KsPublishDeviceProfile-Funktion (ks.h)

Artikel
03/05/2024

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 , die in der KsInitializeDeviceProfile-API verwendet wird.

[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 einen STATUS_INVALID_PARAMETER zurückgibt.

Hinweise

Diese API wird für jedes Profil, das der Kameratreiber unterstützt, wiederholt aufgerufen. Jeder Aufruf kann einen anderen Satz von Parallelitäts- und Datenbereichsinformationen aufweisen. Das Feld ProfileId des KSCAMERA_PROFILE_INFO muss eindeutig sein. Wenn dieselbe ProfileId verwendet wird und sich der Inhalt der Profilinformationen unterscheidet, überschreibt der nachfolgende Aufruf die früheren Profilinformationen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ks.h (include Ksmedia.h)
Bibliothek	Ks.lib

Freigeben über