Función VideoPortGetAccessRanges (video.h)
Obsolescente. La función VideoPortGetAccessRanges recupera información de configuración relativa al bus y, si es posible, reclama estos recursos de hardware en el Registro para el autor de la llamada.
Sintaxis
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetAccessRanges(
PVOID HwDeviceExtension,
ULONG NumRequestedResources,
PIO_RESOURCE_DESCRIPTOR RequestedResources,
ULONG NumAccessRanges,
PVIDEO_ACCESS_RANGE AccessRanges,
PVOID VendorId,
PVOID DeviceId,
PULONG Slot
);
Parámetros
HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
NumRequestedResources
Especifica el número de elementos de la matriz requestedResources de .
RequestedResources
[in, opcional] Matriz de elementos de tipo IO_RESOURCE_DESCRIPTOR. Cada descriptor especifica un único recurso de hardware que el controlador de miniporte necesita, prefiere o puede usar como alternativa a ese especificado en otro elemento de matriz. Para obtener información detallada sobre esta estructura, consulte la descripción de IoAssignResources.
NumAccessRanges
Especifica el número de elementos de la matriz de AccessRanges.
AccessRanges
[out] Puntero a un área de la pila o a una estructura estática en el controlador de miniporte al que VideoPortGetAccessRanges devuelve una matriz de elementos VIDEO_ACCESS_RANGE rellenados con los intervalos de memoria del dispositivo relativos al bus para el adaptador.
VendorId
Debe establecerse en NULL.
DeviceId
Debe establecerse en NULL.
Slot
Puntero a una ubicación de memoria en la que el controlador de puerto de vídeo almacena el número de ranura del dispositivo o es NULL.
En el caso de los dispositivos Plug and Play, si se trata de un puntero válido, el controlador de puerto de vídeo almacena el número de ranura en la ubicación de memoria especificada por el puntero. Si se pasa un valor NULL en la llamada, el controlador de puerto de vídeo no almacena un valor en la ubicación.
Valor devuelto
VideoPortGetAccessRanges devuelve NO_ERROR si rellena correctamente la información de AccessRanges o la información de configuración devuelta en RequestedResources.
Observaciones
Cada controlador de miniporte de vídeo debe usar intervalos de acceso devueltos por VideoPortGetAccessRanges, o debe llamar a VideoPortVerifyAccessRanges antes de intentar acceder a un adaptador de vídeo durante el proceso de inicialización del controlador (y del sistema).
videoPortGetAccessRanges solo se puede llamar desde la función HwVidFindAdapt er del controlador de miniporte.
Para la mayoría de los controladores de miniporte, videoPortGetAccessRanges puede recuperar, comprobar y reclamar los intervalos de acceso relativos al bus y cualquier interrupción o canal DMA usado por un adaptador de vídeo determinado, mientras que VideoPortVerifyAccessRanges solo puede comprobar y reclamar recursos especificados por el controlador de miniporte. Es decir, para toda la información de configuración que devuelve, VideoPortGetAccessRanges reclama los recursos de hardware correspondientes en el registro para el autor de la llamada. Un controlador de miniport no necesita llamar a VideoPortVerifyAccessRanges con la información de configuración relativa al bus devuelto, a menos que el controlador de miniporte intente modificar cualquiera de los valores devueltos.
Cada llamada correcta a VideoPortGetAccessRanges o VideoPortVerifyAccessRanges para un adaptador determinado sobrescribe la notificación anterior del controlador de miniport en los recursos de hardware del registro.
Después de una llamada correcta a VideoPortGetAccessRanges, el controlador de miniport debe asignar los intervalos relativos a bus devueltos a intervalos lógicos con VideoPortGetDeviceBaseantes de llamar a la función adecuada VideoPortRead/Write***Xxx para comunicarse con el adaptador.
Por lo general, el controlador de miniporte de un dispositivo PCI debe tener su HwVidFindAdapter llamada de función VideoPortGetAccessRanges, en lugar de intentar manipular la información de PCI_COMMON_CONFIG específica del dispositivo que devuelve una llamada a VideoPortGetBusData. Este controlador de miniport normalmente puede llamar a videoPortGetAccessRanges con un puntero RequestedResourcesNULL. A continuación, el controlador de puerto de vídeo usa el espacio de configuración del bus PCI para determinar los recursos del adaptador de vídeo. El controlador de miniport puede llamar a VideoPortGetAccessRanges, mediante un conjunto de especificaciones RequestedResources proporcionadas por el controlador, si su llamada original no devuelve datos de configuración válidos para el adaptador.
Tenga en cuenta que los controladores de miniporte de adaptadores en otros tipos de buses de E/S también pueden llamar a VideoPortGetAccessRanges. Estos controladores deben llamar a videoPortGetAccessRanges mediante un puntero RequestedResources a una matriz proporcionada por el controlador de descriptores de recursos de E/S.
Si el HwVidFindAdapter función reclama intervalos de acceso relativos al bus y, posiblemente, otros recursos de hardware para un adaptador, pero, a continuación, determina que no admite el adaptador, entonces el controlador de miniport debe renunciar a sus notificaciones en los recursos de hardware del Registro llamando a VideoPortGetAccessRanges o VideoPortVerifyAccessRanges con el parámetro NumAccessRanges establecido en cero.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
video.h (incluya Video.h) |
| biblioteca de |
Videoprt.lib |
| DLL de |
Videoprt.sys |
| irQL | PASSIVE_LEVEL |
Consulte también