Funzione KsInitializeDriver (ks.h)

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

   
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

Vedi anche

DEVICE_OBJECT

DRIVER_OBJECT

DriverEntry di AVStream

IoCreateDevice

KSDEVICE_DESCRIPTOR

KSDEVICE_DISPATCH

KSFILTER_DESCRIPTOR

KsInitializeDevice