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 Filterfabrik der Kamera eindeutig zu identifizieren.

Rückgabewert

Wenn die bereitgestellte KSFILTERFACTORY- keine Der KSCATEGORY_VIDEO_CAMERAzugeordnete Geräteschnittstelle enthält, schlägt dieser API-Aufruf mit STATUS_INVALID_PARAMETERfehl.

Bemerkungen

Es ist erforderlich, dass das ReferenceGuid Feld der KSFILTER_DESCRIPTOR Struktur in der KSFILTERFACTORY- mit einer eindeutigen GUID für diesen Filtertyp festgelegt werden. Und das feld Flags des KSFILTER_DESCRIPTOR hat den KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID Flag festgelegt.

Um alle Profile aus dem Profilspeicher zu löschen, der der Geräteschnittstelle für diese KSFILTERFACTORY-zugeordnet ist, ruft der Treiber möglicherweise KsInitializeDeviceProfile gefolgt sofort von KsPersistDeviceProfile. Dies würde zu einer leeren Profilinformationen führen, die die Profilinformationen aus dem Profilspeicher entfernen würden.

Anforderungen

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