VideoPortSetBusData-Funktion (video.h)
Die VideoPortSetBusData-Funktion legt Buskonfigurationsdaten für einen Adapter auf einem dynamisch konfigurierbaren E/A-Bus mit einer veröffentlichten Standardschnittstelle fest.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
Parameter
HwDeviceExtension
Zeiger auf die Geräteerweiterung des Miniporttreibers.
BusDataType
Gibt den Typ der festzulegenden Busdaten an. Derzeit kann sein Wert einer von Cmos, EisaConfiguration oder PCIConfiguration sein. In Zukunft können jedoch zusätzliche Typen von standardisierten, dynamisch konfigurierbaren Bussen unterstützt werden. Die Obergrenze für die unterstützten Bustypen ist immer MaximumBusDataType.
SlotNumber
Für einen BusDataType-Wert von CMOS gibt den Standort des Geräts auf dem Bus an. Dieser Parameter sollte für alle anderen Bustypen 0 sein.
[in] Buffer
Zeiger auf einen vom Anrufer bereitgestellten Speicherbereich mit spezifischen Konfigurationsinformationen für BusDataType.
Wenn PCIConfiguration angegeben wird, enthält der Puffer einige oder alle der PCI_COMMON_CONFIG Informationen für die angegebene SlotNumber. Der angegebene Offset und die angegebene Länge bestimmen, wie viele Informationen bereitgestellt werden.
Offset
Gibt den Byteoffset innerhalb der PCI_COMMON_CONFIG-Struktur an, an der die vom Aufrufer bereitgestellten Konfigurationswerte beginnen. Ein Miniporttreiber kann PCI_COMMON_HDR_LENGTH verwenden, um den Offset des gerätespezifischen Bereichs in PCI_COMMON_CONFIG anzugeben.
Length
Gibt die Anzahl der Bytes im Puffer an.
Rückgabewert
VideoPortSetBusData gibt die Anzahl der Bytes zurück, die erfolgreich für die angegebene SlotNumber festgelegt wurden. Wenn der angegebene BusDataType für die aktuelle Plattform ungültig ist oder die bereitgestellten Informationen ungültig sind, gibt VideoPortSetBusData null zurück.
Hinweise
Miniporttreiber von Adaptern auf einem PCI-Bus rufen selten VideoPortSetBusData auf, es sei denn, ungewöhnliche Umstände oder die Art eines bestimmten Treiber-Grafikkartes erfordern einen solchen Anruf.
Beispielsweise kann ein Miniporttreiber VideoPortSetBusData aufrufen, um ein Bit im PCI-status registrieren zu löschen, wenn sein Adapter einen Zielabbruch während der Initialisierung signalisiert. Wenn ein PCI-Grafikkarte mit gerätespezifischen Daten konfiguriert werden muss, ruft der Treiber auch diese Funktion auf. In beiden Fällen wird ein solcher Treiber dann wahrscheinlich VideoPortGetAccessRanges mit einem RequestedResources-Zeiger auf ein vom Treiber bereitgestelltes Array von Ressourcendeskriptoren aufrufen.
VideoPortSetBusData kann nicht von den Funktionen HwVidInterrupt oder HwVidTimer eines Miniporttreibers, von VideoPortQueueDpc oder von einem Rückruf auf VideoPortSynchronizeExecution aufgerufen werden.
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 |