Compartir a través de


Función KsAddDevice (ks.h)

La funciónKsAddDevice es el controlador de 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.

Observaciones

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 Valor
cliente mínimo admitido Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
de la plataforma de destino de Universal
encabezado de ks.h (incluya Ks.h)
biblioteca de Ks.lib
irQL PASSIVE_LEVEL

Consulte también

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KsCreateDevice

KsDispatchIrp

KsInitializeDevice

KsInitializeDriver