Función VideoPortInitialize (video.h)

Artículo
08/08/2023

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.

La rutina DriverEntry del controlador miniporta propaga el valor devuelto por VideoPortInitialize de nuevo a su llamador. Los controladores de minipuerto no deben usar este valor devuelto.

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