Funzione VideoPortGetBusData (video.h)
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 |