VideoPortGetBusData-Funktion (video.h)

Artikel
02/26/2024

Die VideoPortGetBusData-Funktion gibt bustypspezifische Konfigurationsinformationen zurück.

Syntax

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

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

BusDataType

Gibt den Typ der zurückzugebenden Buskonfigurationsdaten an. Der Wert dieses Parameters kann Cmos, EisaConfiguration oder PCIConfiguration sein. In Zukunft werden jedoch möglicherweise zusätzliche Buskonfigurationstypen unterstützt. Die Obergrenze für die unterstützten Typen ist immer MaximumBusDataType.

SlotNumber

Gibt den Standort des Geräts auf dem Bus für einen Cmos BusDataType an. Null für alle anderen Bustypen.

[out] Buffer

Zeiger auf einen Puffer, in den VideoPortGetBusData die Konfigurationsinformationen zurückgibt. Der Inhalt des Puffers hängt wie folgt vom BusDataType ab:

Wenn CMOS angegeben ist, enthält der Puffer den Inhalt der CMOS- (Busnummer gleich Null) oder ECMOS (Busnummer gleich eins) Speicherort, beginnend mit dem für SlotNumber angegebenen Speicherort. Die HwVidFindAdapter-Funktion eines Miniporttreibers kann die Anzahl des Busses aus dem SystemIoBusNumber-Member der VIDEO_PORT_CONFIG_INFO Eingabestruktur bestimmen.
Wenn EisaConfiguration angegeben ist, enthält der Puffer die CM_EISA_SLOT_INFORMATION-Struktur , gefolgt von null oder mehr CM_EISA_FUNCTION_INFORMATION Strukturen für den angegebenen Slot.
Wenn PCIConfiguration angegeben ist, enthält der Puffer die PCI_COMMON_CONFIG Informationen für den angegebenen Slot.

Offset

Gibt den Offset in Bytes in den PCI-Konfigurationsraum an, der abgerufen werden soll, wenn BusDataTypePCIConfiguration ist. andernfalls 0. Weitere Informationen finden Sie unter Hinweise .

Length

Gibt die Länge von Puffer in Bytes an.

Rückgabewert

VideoPortGetBusData gibt die Anzahl von Bytes von Konfigurationsinformationen zurück, die in Buffer geschrieben wurden. Wenn der angegebene BusDataType für die aktuelle Plattform ungültig ist, gibt diese Funktion in der Regel null zurück.

Rückgabecode	Beschreibung
0	Der PCI-Bus ist nicht vorhanden.
2	Der PCI-Bus ist vorhanden, aber Buffer enthält den Wert PCI_INVALID_VENDOR_ID am PCI_COMMON_CONFIG VendorId-Member.

Hinweise

Um nur einen Teil der Konfigurationsinformationen abzurufen, sollte der Miniporttreiber Offset auf den Byteoffset der benötigten Informationen festlegen und Länge auf die Anzahl der Bytes der benötigten Informationen festlegen. Wenn beispielsweise nur das Befehlsregister erforderlich ist, legen Sie Offset auf den Offset dieses Registers fest, und legen Sie Length auf sizeof(USHORT) fest.

Der Treiber sollte VideoPortGetAccessRanges anstelle von VideoPortGetBusData aufrufen, um seine Hardwareressourcen abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (einschließen von Video.h)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL