Funzione KsAddDevice (ks.h)
La funzione KsAddDevice è il gestore AddDevice predefinito 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 che indica che il dispositivo è stato creato correttamente o uno stato di errore da IoCreateDevice o KsInitializeDevice.
Commenti
Normalmente, 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 allocato 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 nessun filtro factory. Il minidriver ha sempre la possibilità di chiamare direttamente KsCreateDevice , in questo caso l'estensione del driver non viene usata da AVStream. Poiché KsAddDevice chiama KsCreateDevice, i driver che chiamano KsAddDevice non devono chiamare separatamente KsCreateDevice .
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 |