Funzione KsInitializeDevice (ks.h)
La funzione KsInitializeDevice viene chiamata da AVStream per inizializzare la classe di dispositivi AVStream dall'interno di KsCreateDevice.
Sintassi
KSDDKAPI NTSTATUS KsInitializeDevice(
[in] PDEVICE_OBJECT FunctionalDeviceObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PDEVICE_OBJECT NextDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Parametri
[in] FunctionalDeviceObject
Puntatore a una struttura DEVICE_OBJECT che rappresenta l'oggetto dispositivo funzionale WDM per il dispositivo da inizializzare.
In genere, questo viene restituito da una chiamata IoCreateDevice. I minidriver che chiamano questa funzione direttamente sono responsabili della chiamata IoCreateDevice e dell'associazione allo stack di dispositivi.
[in] PhysicalDeviceObject
Puntatore a una struttura DEVICE_OBJECT che rappresenta l'oggetto dispositivo fisico WDM per il dispositivo da inizializzare.
[in] NextDeviceObject
Puntatore alla struttura DEVICE_OBJECT successiva nello stack di dispositivi come determinato da una chiamata a IoAttachDeviceToDeviceStack.
[in, optional] Descriptor
Puntatore a una struttura KSDEVICE_DESCRIPTOR che descrive le caratteristiche del dispositivo da inizializzare. Se questo parametro è NULL, il dispositivo viene inizializzato con le caratteristiche predefinite e non ha factory di filtro associate.
Valore restituito
KsInitializeDevice restituisce STATUS_SUCCESS se il dispositivo è stato inizializzato correttamente. In caso contrario, restituisce un codice di errore appropriato.
Osservazioni
La maggior parte dei minidriver non chiama direttamente questa funzione. Chiamare KsInitializeDevice solo se il minidriver non usa KsInitializeDriver per l'inizializzazione, gestisce AddDevice in modo indipendente e non usa KsAddDevice o KsCreateDevice nel gestore AddDevice.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |