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
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
BusDataType
Gibt den Typ der festzulegenden Busdaten an. Derzeit kann sein Wert einer von , EisaConfigurationoder PCIConfigurationsein. Weitere standardisierte, dynamisch konfigurierbare Busse können jedoch in Zukunft unterstützt werden. Die obere Grenze der unterstützten Bustypen wird immer MaximumBusDataType.
SlotNumber
Gibt für einen BusDataType Wert von Aspx-die Position des Geräts im Bus an. Dieser Parameter sollte für alle anderen Bustypen null sein.
[in] Buffer
Zeiger auf einen vom Anrufer bereitgestellten Speicherbereich mit Konfigurationsinformationen, die für BusDataType-spezifisch sind.
Wenn PCIConfiguration- angegeben wird, enthält der Puffer einige oder alle PCI_COMMON_CONFIG Informationen für die angegebene SlotNumber-. Der angegebene Offset- und Länge bestimmen, wie viele Informationen bereitgestellt werden.
Offset
Gibt den Byteoffset innerhalb der PCI_COMMON_CONFIG Struktur an, bei 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 in Puffer-an.
Rückgabewert
VideoPortSetBusData- gibt die Anzahl der Bytes zurück, die für die angegebene SlotNumbererfolgreich 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.
Bemerkungen
Miniporttreiber von Adaptern auf einem PCI-Bus rufen selten VideoPortSetBusDataauf, es sei denn, ungewöhnliche Umstände oder die Art des Grafikkarten eines bestimmten Treibers erfordert einen solchen Anruf.
Beispielsweise kann ein Miniporttreiber VideoPortSetBusData- aufrufen, um ein Bit im PCI-Statusregister zu löschen, wenn der 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 wahrscheinlich VideoPortGetAccessRanges mit einem RequestedResources Zeiger auf ein vom Treiber bereitgestelltes Array von Ressourcendeskriptoren aufrufen.
VideoPortSetBusData- kann nicht von HwVidInterrupt-- oder HwVidTimer--Funktionen oder von VideoPortQueueDpc-oder von einem Rückruf zu VideoPortSynchronizeExecutionaufgerufen werden.
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 |