Funzione VideoPortSetBusData (video.h)
La funzione VideoPortSetBusData imposta i dati di configurazione del bus per una scheda in un bus di I/O configurabile dinamicamente con un'interfaccia standard pubblicata.
Sintassi
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
Parametri
HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
BusDataType
Specifica il tipo di dati del bus da impostare. Attualmente, il suo valore può essere uno dei valori di Cmos, EisaConfiguration o PCIConfiguration. Tuttavia, altri tipi di bus standardizzati e configurabili dinamicamente potrebbero essere supportati in futuro. Il limite superiore dei tipi di bus supportato è sempre MaximumBusDataType.
SlotNumber
Per un valore BusDataType di Cmos, specifica la posizione del dispositivo sul bus. Questo parametro deve essere zero per tutti gli altri tipi di bus.
[in] Buffer
Puntatore a un'area di archiviazione fornita dal chiamante con informazioni di configurazione specifiche di BusDataType.
Quando viene specificato PCIConfiguration , il buffer contiene alcune o tutte le informazioni di PCI_COMMON_CONFIG per slotNumber specificato. L'offset e la lunghezza specificati determinano la quantità di informazioni fornite.
Offset
Specifica l'offset di byte all'interno della struttura PCI_COMMON_CONFIG in cui iniziano i valori di configurazione forniti dal chiamante. Un driver miniport può usare PCI_COMMON_HDR_LENGTH per specificare l'offset dell'area specifica del dispositivo in PCI_COMMON_CONFIG.
Length
Specifica il numero di byte nel buffer.
Valore restituito
VideoPortSetBusData restituisce il numero di byte di dati impostati correttamente per slotNumber specificato. Se il busDataType specificato non è valido per la piattaforma corrente o se le informazioni fornite non sono valide, VideoPortSetBusData restituisce zero.
Commenti
I driver miniport delle schede su un bus PCI chiamano raramente VideoPortSetBusData, a meno che non siano circostanze insolite o la natura di una determinata scheda video del driver richiede una chiamata di questo tipo.
Ad esempio, un driver miniport potrebbe chiamare VideoPortSetBusData per cancellare un bit nel registro di stato PCI se la scheda segnala un'interruzione di destinazione durante l'inizializzazione. Se una scheda video PCI deve essere configurata con dati specifici del dispositivo, il driver chiama anche questa funzione. In entrambi i casi, tale driver è probabilmente chiamare VideoPortGetAccessRanges con un puntatore RequestedResources a una matrice di descrittori di risorse fornita dal driver.
VideoPortSetBusData non può essere chiamato dalle funzioni HwVidInterrupt o HwVidTimer o da VideoPortQueueDpc o da un callback a VideoPortSynchronizeExecution.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (includere Video.h) |
| Libreria | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |