Función KsInitializeDevice (ks.h)

2025-02-07

AVStream llama a la funciónKsInitializeDevice para inicializar la clase de dispositivo AVStream desde KsCreateDevice.

Sintaxis

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parámetros

[in] FunctionalDeviceObject

Puntero a una estructura de DEVICE_OBJECT que representa el objeto de dispositivo funcional WDM para el dispositivo que se va a inicializar.

Normalmente, esto se devuelve desde una llamada de ioCreateDevice. Los minidrivers que llaman directamente a esta función son responsables de llamar a IoCreateDevice y asociarse a sí mismos a la pila de dispositivos.

[in] PhysicalDeviceObject

Puntero a una estructura de DEVICE_OBJECT que representa el objeto de dispositivo físico WDM para el dispositivo que se va a inicializar.

[in] NextDeviceObject

Puntero a la siguiente estructura DEVICE_OBJECT de la pila de dispositivos determinada por una llamada a IoAttachDeviceToDeviceStack.

[in, optional] Descriptor

Puntero a una estructura KSDEVICE_DESCRIPTOR que describe las características del dispositivo que se va a inicializar. Si este parámetro es NULL, el dispositivo se inicializa con las características predeterminadas y no tiene generadores de filtros asociados.

Valor devuelto

KsInitializeDevice devuelve STATUS_SUCCESS si el dispositivo se inicializó correctamente. De lo contrario, devuelve un código de error adecuado.

Observaciones

La mayoría de los minidrivers no llaman directamente a esta función. Solo llame a KsInitializeDevice si el minidriver no usa KsInitializeDriver para la inicialización, controla AddDevice de forma independiente y no usa KsAddDevice ni KsCreateDevice en su controlador AddDevice.

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