DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY Rückruffunktion (dispmprt.h)
Die DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY Rückruffunktion überträgt Daten an ein I2C-Gerät in einem Monitor.
Syntax
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY DxgkddiI2cTransmitDataToDisplay;
NTSTATUS DxgkddiI2cTransmitDataToDisplay(
[in] PVOID MiniportDeviceContext,
[in] D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[in] ULONG SevenBitI2CAddress,
[in] ULONG DataLength,
[in] const VOID *Data
)
{...}
Parameter
[in] MiniportDeviceContext
Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers dieses Handle zuvor für das Microsoft DirectX-Grafik-Kernel-Subsystem bereitgestellt.
[in] VidPnTargetId
Eine ganze Zahl, die einen der Videodaten identifiziert, die auf dem Grafikkartenziel vorhanden sind.
[in] SevenBitI2CAddress
Die Adresse des I2C-Geräts, an das Daten übermittelt werden.
[in] DataLength
Die Länge der zu übertragenden Daten in Bytes. Dieser Parameter muss zwischen 1 und 64 (einschließlich) liegen.
[in] Data
Ein Zeiger auf einen Puffer, der die zu übertragenden Daten enthält.
Rückgabewert
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird eine der fehlercodes zurückgegeben, die in ntstatus.hdefiniert sind. Die folgende Liste enthält einige der möglichen Fehlercodes, die zurückgegeben werden können.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Es ist kein Monitor mit der von VidPnTargetId identifizierten Videoausgabe verbunden. |
| STATUS_GRAPHICS_I2C_NOT_SUPPORTED | Die von VidPnTargetId identifizierte Videoausgabe verfügt nicht über einen I2C-Bus. |
| STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST | Kein Gerät hat die in SevenBitI2CAddress angegebene I2C-Adresse bestätigt. Dies kann bedeuten, dass kein Gerät auf dem I2C-Bus die angegebene Adresse hat oder dass beim Übertragen der Adresse ein Fehler aufgetreten ist. |
| STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA | Die I2C-Adresse wurde erfolgreich übertragen, aber es gab einen Fehler beim Übertragen von Daten an das I2C-Gerät. |
Bemerkungen
Das video present target identified by VidPnTargetId is associated with one of the video outputs on the display adapter. Die Daten werden an ein I2C-Gerät auf dem Monitor übertragen, der mit dieser Videoausgabe verbunden ist.
DxgkDdiI2CTransmitDataToDisplay ist verantwortlich für das Signal der I2C-Startbedingung, das Senden der I2C-Adresse, das Senden der Daten im Puffer, die Überprüfung auf Bestätigungen des Empfängers und signalisieren die Beendigungsbedingung. Details zum I2C-Bus finden Sie in der I2C Bus Specification, veröffentlicht von Philips Semiconductors. Die Spezifikation definiert ein Protokoll zum Initiieren der I2C-Kommunikation, zum Lesen und Schreiben von Bytes über die I2C-Datenzeile und zum Beenden der I2C-Kommunikation.
DxgkDdiI2CTransmitDataToDisplay- ist erforderlich, um Daten an ein I2C-Gerät zu übertragen, das die Adresse 0x6E hat, aber die Übertragung von Daten an jedes I2C-Gerät mit einer anderen Adresse verweigert.
DxgkDdiI2CTransmitDataToDisplay kann blockiert werden, wenn ein anderer Teil des Display Miniporttreibers oder der Grafikhardware den I2C-Bus des angegebenen Monitors verwendet. Es ist auch erlaubt, zu blockieren, wenn der Display-Miniporttreiber den I2C-Bus zum Senden oder Empfangen von HDCP-Daten (High-Bandwidth Digital Content Protection) verwendet.
Wenn der Anzeigeadapter HDCP unterstützt, muss die DxgkDdiI2CTransmitDataToDisplay-Funktion das Senden von Daten an ein I2C-Gerät verweigern, wenn das Gerät über eine I2C-Adresse verfügt, die von HDCP verwendet wird.
DxgkDdiI2CTransmitDataToDisplay dürfen niemals Daten an ein I2C-Gerät auf dem Displayadapter übertragen. Das heißt, diese Funktion kann Daten an ein I2C-Gerät in einem Monitor übertragen, der mit dem Displayadapter verbunden ist, aber nicht an ein I2C-Gerät, das sich auf dem Displayadapter selbst befindet.
DxgkDdiI2CTransmitDataToDisplay sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | PASSIVE_LEVEL |