Funzione KsInitializeDeviceProfile (ks.h)

L'API KsInitializeDeviceProfile deve essere chiamata da tutti i driver miniport per inizializzare l'archivio profili e pubblicare i profili del dispositivo.

Sintassi

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Parametri

[in] FilterFactory

Si tratta della KSFILTERFACTORY creata dal driver della fotocamera per identificare in modo univoco la fabbrica di filtri della fotocamera.

Valore restituito

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

Commenti

È necessario impostare il campo ReferenceGuid della struttura KSFILTER_DESCRIPTOR contenuta con KSFILTERFACTORY con un GUID univoco per questo tipo di filtro. E il campo Flagsdell'KSFILTER_DESCRIPTOR ha il flag KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID impostato.

Per eliminare tutti i profili dall'archivio profili associati 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ks.h (includere Ksmedia.h)
Libreria	Ks.lib