Funzione VideoPortSetBusData (video.h)

Articolo
08/08/2023

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