Función KsInitializeDriver (ks.h)

Artículo
02/29/2024

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 pasada a la función DriverEntry del minidriver 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 no hay generadores de filtros asociados.

Valor devuelto

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

Comentarios

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 el momento de AddDevice . Los minicontroladores que realizan la inicialización del dispositivo por sí mismos no necesitan necesariamente llamar a KsInitializeDriver. Para obtener más información, consulte Inicialización de un minidriver AVStream.

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