Funzione KsInitializeDevice (ks.h)
La funzione KsInitializeDevice viene chiamata da AVStream per inizializzare la classe di dispositivo 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 inizializzato.
In genere, viene restituito da una chiamata IoCreateDevice . I minidriver che chiamano questa funzione direttamente sono responsabili della chiamata di IoCreateDevice e dell'associazione stessa allo stack di dispositivi.
[in] PhysicalDeviceObject
Puntatore a una struttura DEVICE_OBJECT che rappresenta l'oggetto dispositivo fisico WDM per il dispositivo inizializzato.
[in] NextDeviceObject
Puntatore alla struttura di DEVICE_OBJECT successiva nello stack di dispositivi, come determinato da una chiamata a IoAttachDeviceToDeviceToDeviceStack.
[in, optional] Descriptor
Puntatore a una struttura KSDEVICE_DESCRIPTOR che descrive le caratteristiche del dispositivo inizializzato. Se questo parametro è NULL, il dispositivo viene inizializzato con le caratteristiche predefinite e non ha filtri factory associati.
Valore restituito
KsInitializeDevice restituisce STATUS_SUCCESS se il dispositivo è stato inizializzato correttamente. In caso contrario, restituisce un codice di errore appropriato.
Commenti
La maggior parte dei minidriver non chiama direttamente questa funzione. Chiamare solo KsInitializeDevice se il minidriver non usa KsInitializeDriver per l'inizializzazione, gestisce AddDevice in modo indipendente e non usa KsAddDevice o KsCreateDevice nel relativo gestore AddDevice .
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 |