Función VideoPortInitialize (video.h)
La función VideoPortInitialize realiza parte de la inicialización del controlador de miniporte, asignando recursos del sistema para el controlador de minipuerto.
Sintaxis
VIDEOPORT_API ULONG VideoPortInitialize(
PVOID Argument1,
PVOID Argument2,
PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
PVOID HwContext
);
Parámetros
Argument1
Puntero con el que el sistema operativo llamó DriverEntry of Video Miniport Driver.
Argument2
Segundo puntero con el que el sistema operativo llamó DriverEntry.
HwInitializationData
Puntero a la estructura VIDEO_HW_INITIALIZATION_DATA de la pila. La rutina DriverEntry del controlador de miniporte inicializó sin inicializar esta estructura y, a continuación, la rellena con información de configuración específica del controlador que describe un adaptador de vídeo que el controlador de miniporte puede admitir.
HwContext
Debe ser NULL.
Valor devuelto
VideoPortInitialize devuelve el estado final de la operación de inicialización.
Comentarios
Cada controlador de minipuerto de vídeo debe llamar a VideoPortInitialize desde su función DriverEntry . DriverEntry solo puede llamar a VideoPortInitialize después de que se haya inicializado cero primero y, a continuación, configurar la estructura VIDEO_HW_INITIALIZATION_DATA . Solo se puede llamar a VideoPortInitialize desde una función DriverEntry del controlador de miniport.
La función VideoPortInitialize :
- Comprueba la validez de las especificaciones de VIDEO_HW_INITIALIZATION_DATA del controlador de miniporte.
- Asigna memoria para y inicializa cero una estructura de VIDEO_PORT_CONFIG_INFO .
- Rellena tanto la información de configuración del adaptador como pueda en VIDEO_PORT_CONFIG_INFO.
- Rellena algunos de los miembros públicos del objeto de dispositivo creado por el sistema para representar el adaptador de gráficos. El controlador de puerto de vídeo administra los objetos de dispositivo, por lo tanto, el controlador de minipuerto no debe preocuparse por los detalles del objeto del dispositivo.
- Asigna memoria para y inicializa cero la extensión del dispositivo del objeto de dispositivo. Una extensión de dispositivo es el área de almacenamiento principal y solo del controlador de minipuerto para la información de estado específica del adaptador. El controlador de minipuerto especifica el tamaño de la extensión del dispositivo en el miembro HwDeviceExtensionSize de VIDEO_HW_INITIALIZATION_DATA. El controlador de puerto de vídeo pasa esta extensión de dispositivo a la mayoría de las funciones del controlador de minipuerto a las que llama.
- Recopila y almacena información pertinente en la extensión del dispositivo.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
Plataforma de destino | Escritorio |
Encabezado | video.h (incluir Video.h) |
Library | Videoprt.lib |
Archivo DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |