Funzione KsInitializeDriver (ks.h)

Articolo
02/26/2024

La funzione KsInitializeDriver inizializza l'oggetto driver di un minidriver AVStream.

Sintassi

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parametri

[in] DriverObject

Puntatore alla struttura DRIVER_OBJECT per il driver AVStream inizializzato. I minidriver che chiamano KsInitializeDriver devono usare l'oggetto driver passato a DriverEntry dal sistema operativo.

[in] RegistryPathName

Puntatore a una stringa Unicode contenente la stringa del percorso del Registro di sistema passata alla funzione DriverEntry del minidriver dal sistema operativo.

[in, optional] Descriptor

Puntatore a una struttura KSDEVICE_DESCRIPTOR che specifica le caratteristiche del dispositivo inizializzato. Se questo puntatore è NULL, viene creato un dispositivo con caratteristiche predefinite e nessuna factory di filtri associata.

Valore restituito

KsInitializeDriver restituisce STATUS_SUCCESS o un codice di errore appropriato restituito da IoCreateDevice o routine di inizializzazione interna del dispositivo AVStream.

Commenti

Questa funzione viene in genere chiamata da DriverEntry. Se il minidriver passa in un descrittore del dispositivo, AVStream crea un dispositivo con le caratteristiche specificate in fase di AddDevice . I minidriver che eseguono l'inizializzazione del dispositivo non devono necessariamente chiamare KsInitializeDriver. Per altre informazioni, vedere Inizializzazione di un minidriver AVStream.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib
IRQL	PASSIVE_LEVEL