KsInitializeDeviceProfile-Funktion (ks.h)

Die KsInitializeDeviceProfile-API muss von allen Miniporttreibern aufgerufen werden, um den Profilspeicher zu initialisieren und die Geräteprofile zu veröffentlichen.

Syntax

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Parameter

[in] FilterFactory

Dies ist die KSFILTERFACTORY , die vom Kameratreiber erstellt wurde, um die Filterfactory der Kamera eindeutig zu identifizieren.

Rückgabewert

Wenn die bereitgestellte KSFILTERFACTORY keine Geräteschnittstelle enthält, die dem KSCATEGORY_VIDEO_CAMERA zugeordnet ist, schlägt dieser API-Aufruf mit STATUS_INVALID_PARAMETER fehl.

Hinweise

Es ist erforderlich, dass das ReferenceGuid-Feld der KSFILTER_DESCRIPTOR-Struktur , die in der KSFILTERFACTORY enthalten ist, mit einer eindeutigen GUID für diesen Filtertyp festgelegt wird. Im Feld Flags des KSFILTER_DESCRIPTOR ist das flag KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID festgelegt.

Um alle Profile aus dem Profilspeicher zu löschen, der der Geräteschnittstelle für diese KSFILTERFACTORY zugeordnet ist, kann der Treiber KsInitializeDeviceProfile aufrufen, gefolgt von KsPersistDeviceProfile. Dies würde zu einer leeren Profilinformation führen, die die Profilinformationen aus dem Profilspeicher entfernt.

Anforderungen

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