Función KsInitializeDevice (ks.h)

Artículo
08/07/2023

AVStream llama a la función KsInitializeDevice 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 está inicializando.

Normalmente, esto se devuelve desde una llamada a 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 de KSDEVICE_DESCRIPTOR que describe las características del dispositivo que se está inicializando. 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.

Comentarios

La mayoría de los minidrivers no llaman directamente a esta función. Llame solo 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	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL