Función KsAddDevice (ks.h)
La función KsAddDevice es el controlador AddDevice predeterminado instalado por KsInitializeDriver.
Sintaxis
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Parámetros
[in] DriverObject
Puntero al objeto de controlador WDM para el minidriver.
[in] PhysicalDeviceObject
Puntero al objeto de dispositivo físico WDM.
Valor devuelto
Devuelve STATUS_SUCCESS que indica que el dispositivo se creó correctamente o un estado de error de IoCreateDevice o KsInitializeDevice.
Comentarios
Normalmente, un minidriver AVStream no llama directamente a esta función.
Para obtener más información, vea AddDevice Routine for AVStream Minidrivers.
KsAddDevice extrae el descriptor de dispositivo almacenado en la extensión de dispositivo asignada desde una llamada a KsInitializeDriver y crea el dispositivo descrito por él. Si KsInitializeDriver no se usa para inicializar el controlador, esta función crea un dispositivo con las características predeterminadas y sin generadores de filtros. El minidriver siempre tiene la opción de llamar directamente a KsCreateDevice , en cuyo caso avStream no usa la extensión del controlador. Dado que KsAddDevice llama a KsCreateDevice, los controladores que llaman a KsAddDevice no deben llamar a KsCreateDevice por separado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |