KsPublishDeviceProfile-Funktion (ks.h)

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