Función KsInitializeDriver (ks.h)

2025-02-07

La función KsInitializeDriver inicializa el objeto de controlador de un minidriver AVStream.

Sintaxis

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parámetros

[in] DriverObject

Puntero a la estructura DRIVER_OBJECT del controlador AVStream que se va a inicializar. Los minidrivers que llaman a KsInitializeDriver deben usar el objeto de controlador pasado a DriverEntry por el sistema operativo.

[in] RegistryPathName

Puntero a una cadena Unicode que contiene la cadena de ruta de acceso del Registro que se pasa al DriverEntry del minidriver función por el sistema operativo.

[in, optional] Descriptor

Puntero a una estructura KSDEVICE_DESCRIPTOR que especifica las características del dispositivo que se va a inicializar. Si este puntero es NULL, se crea un dispositivo con características predeterminadas y sin generadores de filtros asociados.

Valor devuelto

KsInitializeDriver devuelve STATUS_SUCCESS o un código de error adecuado tal como lo devuelve ioCreateDevice o rutinas internas de inicialización de dispositivos AVStream.

Observaciones

Normalmente, se llama a esta función desde DriverEntry. Si el minidriver pasa en un descriptor de dispositivo, AVStream crea un dispositivo con las características especificadas en tiempo AddDevice. Los minidrivers que realizan la inicialización de dispositivos por sí mismos no necesitan llamar necesariamente a KsInitializeDriver. Para obtener más información, vea Inicializar un minidriver avStream.

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