Поделиться через


функция обратного вызова DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY (dispmprt.h)

Функция обратного вызова DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY передает данные на устройство I2C в мониторе.

Синтаксис

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
)
{...}

Параметры

[in] MiniportDeviceContext

Дескриптор к блоку контекста, связанному с адаптером отображения. Функция драйвера мини-порта дисплея DxgkDdiAddDevice ранее предоставила этот дескриптор подсистеме ядра графики Microsoft DirectX.

[in] VidPnTargetId

Целое число, определяющее один из целевых объектов видео, присутствующих на адаптере дисплея.

[in] SevenBitI2CAddress

Адрес устройства I2C, на которое будут передаваться данные.

[in] DataLength

Длина передаваемых данных в байтах. Этот параметр должен быть от 1 до 64 включительно.

[in] Data

Указатель на буфер, содержащий передаваемые данные.

Возвращаемое значение

DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY возвращает STATUS_SUCCESS, если он успешно выполнен. В противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h. В следующем списке приведены некоторые возможные коды ошибок, которые можно вернуть.

Возвращаемый код Описание
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED Монитор не подключен к выходным данным видео, определяемым VidPnTargetId.
STATUS_GRAPHICS_I2C_NOT_SUPPORTED Выходные данные видео, определяемые VidPnTargetId, не имеют шины I2C.
STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST Устройство не признало адрес I2C, предоставленный в SevenBitI2CAddress. Это может означать, что устройство на шине I2C не имеет указанного адреса или что произошла ошибка при передаче адреса.
STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA Адрес I2C успешно передан, но произошла ошибка передачи данных на устройство I2C.

Замечания

Цель представления видео, определяемая VidPnTargetId, связана с одним из выходных данных видео на адаптере отображения. Данные передаются на устройство I2C в мониторе, подключенном к выходным данным видео.

DxgkDdiI2CTransmitDataToDisplay отвечает за сигнал о состоянии запуска I2C, отправке данных в буфере, проверке подтверждения от приемника и сигнализации условия остановки. Дополнительные сведения об автобусе I2C см. в спецификации шины I2C, опубликованной Philips Semis. Спецификация определяет протокол для инициирования связи I2C, чтения и записи байтов через линию данных I2C и прекращения связи I2C.

DxgkDdiI2CTransmitDataToDisplay требуется для передачи данных на устройство I2C с адресом 0x6E, но разрешено отказаться от передачи данных на любое устройство I2C с другим адресом.

DxgkDdiI2CTransmitDataToDisplay разрешено блокировать, если другая часть драйвера минипорта дисплея или графического оборудования использует шину I2C указанного монитора. Также разрешено блокировать, если драйвер мини-порта дисплея использует шину I2C для отправки или получения данных HDCP с высокой пропускной способностью.

Если адаптер дисплея поддерживает HDCP, функция DxgkDdiI2CTransmitDataToDisplay должна отказаться от отправки данных на устройство I2C, если устройство имеет адрес I2C, используемый HDCP.

DxgkDdiI2CTransmitDataToDisplay никогда не должен передавать данные на устройство I2C на адаптере дисплея. То есть эта функция может передавать данные на устройство I2C в мониторе, подключенном к адаптеру дисплея, но не к устройству I2C, которое находится на самом адаптере дисплея.

DxgkDdiI2CTransmitDataToDisplay должен быть доступен для страницы.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista
целевая платформа Настольный
заголовка dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

См. также

DxgkDdiAddDevice

DxgkDdiI2CReceiveDataFromDisplay