Funzione KsInitializeDeviceProfile (ks.h)

Il KsInitializeDeviceProfile API deve essere chiamato da tutti i driver miniport per inizializzare l'archivio profili e pubblicare i profili di dispositivo.

Sintassi

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Parametri

[in] FilterFactory

Questo è il KSFILTERFACTORY creato dal driver della fotocamera per identificare in modo univoco la factory di filtro della fotocamera.

Valore restituito

Se l' KSFILTERFACTORY specificato non contiene un'interfaccia del dispositivo associata all'KSCATEGORY_VIDEO_CAMERA, questa chiamata API avrà esito negativo con STATUS_INVALID_PARAMETER.

Osservazioni

È necessario che il campo ReferenceGuid della struttura di KSFILTER_DESCRIPTOR contenuta nell'KSFILTERFACTORY essere impostato con un GUID univoco per questo tipo di filtro. Il campo Flag del KSFILTER_DESCRIPTOR ha impostato il flag KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID.

Per eliminare tutti i profili dall'archivio profili associato all'interfaccia del dispositivo per questo KSFILTERFACTORY, il driver può chiamare KsInitializeDeviceProfile seguito immediatamente da KsPersistDeviceProfile. Ciò comporta informazioni sul profilo vuote, che rimuoverebbero le informazioni sul profilo dall'archivio profili.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	ks.h (include Ksmedia.h)
libreria	Ks.lib