Funzione VideoPortGetBusData (video.h)

Articolo
08/07/2023

La funzione VideoPortGetBusData restituisce informazioni di configurazione specifiche del tipo di bus.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
        PVOID         HwDeviceExtension,
        BUS_DATA_TYPE BusDataType,
        ULONG         SlotNumber,
  [out] PVOID         Buffer,
        ULONG         Offset,
        ULONG         Length
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

BusDataType

Specifica il tipo di dati di configurazione del bus da restituire. Il valore di questo parametro puòessereoe, EisaConfiguration o PCIConfiguration. Tuttavia, in futuro potrebbero essere supportati altri tipi di configurazione del bus. Il limite superiore sui tipi supportati è sempre MaximumBusDataType.

SlotNumber

Specifica la posizione del dispositivo sull'autobus per un bus BusDataType DiType; zero per tutti gli altri tipi di bus.

[out] Buffer

Puntatore a un buffer in cui VideoPortGetBusData restituisce le informazioni di configurazione. Il contenuto del buffer dipende da BusDataType, come indicato di seguito:

Se viene specificato Il buffer contiene il contenuto dell'oggetto WCF (numero di bus uguale a zero) o ECMOS (numero di bus uguale a uno), a partire dalla posizione specificata per SlotNumber. La funzione HwVidFindAdapter di un driver miniport può determinare il numero del bus dal membro SystemIoBusNumber della struttura di input VIDEO_PORT_CONFIG_INFO .
Se viene specificato EisaConfiguration , il buffer contiene la struttura CM_EISA_SLOT_INFORMATION seguita da zero o più strutture CM_EISA_FUNCTION_INFORMATION per lo slot specificato.
Se si specifica PCIConfiguration , il buffer contiene le informazioni PCI_COMMON_CONFIG per lo slot specificato.

Offset

Specifica l'offset, in byte, nello spazio di configurazione PCI che deve essere recuperato se BusDataType è PCIConfiguration; in caso contrario, zero. Vedere osservazioni Per ulteriori informazioni.

Length

Specifica la lunghezza, in byte, di Buffer.

Valore restituito

VideoPortGetBusData restituisce il numero di byte di informazioni di configurazione scritte in Buffer. Se il valore BusDataType specificato non è valido per la piattaforma corrente, questa funzione restituisce in genere zero.

Codice restituito	Descrizione
0	Il bus PCI non esiste.
2	Il bus PCI esiste, ma Buffer contiene il valore PCI_INVALID_VENDOR_ID nel membro PCI_COMMON_CONFIG VendorId.

Commenti

Per ottenere solo una parte delle informazioni di configurazione, il driver miniport deve impostare Offset sull'offset di byte delle informazioni necessarie e impostare Length sul numero di byte delle informazioni necessarie. Ad esempio, se è necessario solo il registro dei comandi, impostare Offset sull'offset del registro e impostare Length su sizeof(USHORT).

Il driver deve chiamare VideoPortGetAccessRanges anziché VideoPortGetBusData per recuperare le risorse hardware.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL