Funzione KsAddDevice (ks.h)
La funzione KsAddDevice è il gestore predefinito AddDevice installato da KsInitializeDriver.
Sintassi
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Parametri
[in] DriverObject
Puntatore all'oggetto driver WDM per il minidriver.
[in] PhysicalDeviceObject
Puntatore all'oggetto dispositivo fisico WDM.
Valore restituito
Restituisce STATUS_SUCCESS indicante che il dispositivo è stato creato correttamente o uno stato di errore da IoCreateDevice o KsInitializeDevice.
Osservazioni
In genere, un minidriver AVStream non chiama direttamente questa funzione.
Per altre informazioni, vedere AddDevice Routine for AVStream Minidrivers.
KsAddDevice estrae il descrittore del dispositivo archiviato nell'estensione del dispositivo allocata da una chiamata a KsInitializeDriver e crea il dispositivo descritto da esso. Se KsInitializeDriver non viene usato per inizializzare il driver, questa funzione crea un dispositivo con le caratteristiche predefinite e nessuna factory di filtro. Il minidriver ha sempre la possibilità di chiamare KsCreateDevice direttamente, nel qual caso l'estensione del driver non viene usata da AVStream. Poiché KsAddDevice chiama KsCreateDevice, i driver che chiamano KsAddDevice non devono chiamare KsCreateDevice separatamente.
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 |