Funzione VideoPortGetAccessRanges (video.h)

Articolo
07/16/2024

Deprecato. La funzione VideoPortGetAccessRanges recupera le informazioni di configurazione relative al bus e, se possibile, richiede queste risorse hardware nel Registro di sistema per il chiamante.

Sintassi

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
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

NumRequestedResources

Specifica il numero di elementi nella matrice RequestedResources .

RequestedResources

[in, facoltativo] Matrice di elementi di tipo IO_RESOURCE_DESCRIPTOR. Ogni descrittore specifica una singola risorsa hardware necessaria per il driver miniport, preferisce o può essere usata come alternativa a quella specificata in un altro elemento di matrice. Per informazioni dettagliate su questa struttura, vedere la descrizione di IoAssignResources.

NumAccessRanges

Specifica il numero di elementi nella matrice di AccessRanges.

AccessRanges

[out] Puntatore a un'area nello stack o a una struttura statica nel driver miniport a cui VideoPortGetAccessRanges restituisce una matrice di VIDEO_ACCESS_RANGE elementi riempiti con gli intervalli di memoria del dispositivo relativi al bus per l'adattatore.

VendorId

Deve essere impostato su NULL.

DeviceId

Deve essere impostato su NULL.

Slot

Puntatore a una posizione di memoria in cui il driver della porta video archivia il numero di slot per il dispositivo o è NULL.

Per i dispositivi Plug and Play, se si tratta di un puntatore valido, il driver della porta video archivia il numero di slot nella posizione di memoria specificata dal puntatore. Se viene passato un valore NULL nella chiamata, il driver della porta video non archivia un valore nella posizione.

Valore restituito

VideoPortGetAccessRanges restituisce NO_ERROR se l'AccessRanges informazioni o le informazioni di configurazione restituite in RequestedResources.

Osservazioni

Ogni driver miniport video deve usare intervalli di accesso restituiti da VideoPortGetAccessRangesoppure deve chiamare VideoPortVerifyAccessRanges prima di tentare di accedere a una scheda video durante il processo di inizializzazione del driver e del sistema.

VideoPortGetAccessRanges può essere chiamato solo dalla funzione di di un driver miniport HwVidFindAdapter.

Per la maggior parte dei driver miniport, VideoPortGetAccessRanges può recuperare, verificare e richiedere gli intervalli di accesso relativi al bus e qualsiasi interrupt e/o canale/porta DMA usato da una scheda video specifica, mentre VideoPortVerifyAccessRanges può solo verificare e richiedere risorse specificate dal driver miniport. Ovvero, per tutte le informazioni di configurazione restituite, VideoPortGetAccessRanges attestazioni le risorse hardware corrispondenti nel Registro di sistema per il chiamante. Un driver miniport non deve chiamare VideoPortVerifyAccessRanges con le informazioni di configurazione relative al bus restituite, a meno che il driver miniport non tenti di modificare uno dei valori restituiti.

Ogni chiamata riuscita a VideoPortGetAccessRanges o VideoPortVerifyAccessRanges per una determinata scheda sovrascrive l'attestazione precedente del driver miniport sulle risorse hardware nel Registro di sistema.

Dopo una chiamata riuscita a VideoPortGetAccessRanges, il driver miniport deve eseguire il mapping degli intervalli relativi al bus restituiti a intervalli logici con VideoPortGetDeviceBaseprima di chiamare la funzione VideoPortRead/Write++Xxx appropriata per comunicare con la scheda.

In genere, il driver miniport di un dispositivo PCI deve avere il proprio HwVidFindAdapter chiamata di funzione VideoPortGetAccessRanges, anziché tentare di modificare le informazioni PCI_COMMON_CONFIG non specifiche del dispositivo restituite da una chiamata a VideoPortGetBusData. Questo driver miniport può in genere chiamare VideoPortGetAccessRanges con un puntatore nullRequestedResources. Il driver della porta video usa quindi lo spazio di configurazione del bus PCI per determinare le risorse per la scheda video. Il driver miniport può chiamare VideoPortGetAccessRanges, usando un set di requestedResources specifiche, se la chiamata originale non restituisce dati di configurazione validi per l'adattatore.

Si noti che i driver miniport delle schede su altri tipi di bus di I/O possono anche chiamare VideoPortGetAccessRanges. Questi driver devono chiamare VideoPortGetAccessRanges usando un puntatore RequestedResources a una matrice di descrittori di risorse I/O fornita dal driver.

Se il HwVidFindAdapter funzione richiede intervalli di accesso relativi al bus ed eventualmente altre risorse hardware per un adattatore, ma quindi determina che non supporta l'adattatore, il driver miniport deve rinunciare alle attestazioni sulle risorse hardware nel Registro di sistema chiamando VideoPortGetAccessRanges o VideoPortVerifyAccessRanges con il parametro NumAccessRanges impostato su zero.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000
piattaforma di destinazione	Desktop
intestazione	video.h (includere Video.h)
libreria	Videoprt.lib
dll	Videoprt.sys
IRQL	PASSIVE_LEVEL