Funzione KsInitializeDevice (ks.h)

Articolo
02/29/2024

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