VideoPortGetBusData-Funktion (video.h)
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
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
BusDataType
Gibt den Typ der zurückzugebenden Buskonfigurationsdaten an. Der Wert dieses Parameters kann , EisaConfigurationoder PCIConfigurationsein. Weitere Buskonfigurationstypen können jedoch in Zukunft unterstützt werden. Die obere Grenze der unterstützten Typen wird immer MaximumBusDataType.
SlotNumber
Gibt die Position des Geräts auf dem Bus für ein BusDataType; 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 von der BusDataType-wie folgt ab:
- Wenn Aspx- angegeben ist, enthält der Puffer den Inhalt der ASPX-Position (Busnummer gleich Null) oder ECMOS (Busnummer ist gleich einer) Position, beginnend mit der für SlotNumberangegebenen Position. Die HwVidFindAdapter Funktion eines Miniporttreibers kann die Anzahl des Busses aus dem SystemIoBusNumber Element der VIDEO_PORT_CONFIG_INFO Eingabestruktur bestimmen.
- Wenn EisaConfiguration- angegeben wird, enthält der Puffer die CM_EISA_SLOT_INFORMATION Struktur, gefolgt von null oder mehr CM_EISA_FUNCTION_INFORMATION Strukturen für den angegebenen Steckplatz.
- Wenn PCIConfiguration- angegeben wird, enthält der Puffer die PCI_COMMON_CONFIG Informationen für den angegebenen Steckplatz.
Offset
Gibt den Offset in Bytes in den PCI-Konfigurationsraum an, der abgerufen werden soll, wenn BusDataType-PCIConfigurationist; andernfalls 0. Weitere Informationen finden Sie in Anmerkungen.
Length
Gibt die Länge Puffer-in Byte an.
Rückgabewert
VideoPortGetBusData- gibt die Anzahl der Bytes von Konfigurationsinformationen zurück, die sie in Buffergeschrieben hat. 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 Member PCI_COMMON_CONFIG VendorId. |
Bemerkungen
Um nur einen Teil der Konfigurationsinformationen abzurufen, sollte der Miniporttreiber Offset- auf den Byte-Offset der benötigten Informationen festlegen und Länge auf die Anzahl der erforderlichen 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- und nicht VideoPortGetBusData- aufrufen, um seine Hardwareressourcen abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |
| Library | Videoprt.lib |
| DLL- | Videoprt.sys |
| IRQL- | PASSIVE_LEVEL |