Función KsInitializeDriver (ks.h)
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 |