DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY función de devolución de llamada (dispmprt.h)
La función de devolución de llamada DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY transmite datos a un dispositivo I2C en un monitor.
Sintaxis
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
)
{...}
Parámetros
[in] MiniportDeviceContext
Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX.
[in] VidPnTargetId
Entero que identifica uno de los destinos de presentación de vídeo en el adaptador de pantalla.
[in] SevenBitI2CAddress
Dirección del dispositivo I2C al que se transmitirán los datos.
[in] DataLength
Longitud, en bytes, de los datos que se van a transmitir. Este parámetro debe estar comprendido entre 1 y 64, ambos incluidos.
[in] Data
Puntero a un búfer que contiene los datos que se van a transmitir.
Valor devuelto
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY devuelve STATUS_SUCCESS si se realiza correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h. En la lista siguiente se proporcionan algunos de los posibles códigos de error que se pueden devolver.
| Código devuelto | Descripción |
|---|---|
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | No hay ningún monitor conectado a la salida de vídeo identificada por VidPnTargetId. |
| STATUS_GRAPHICS_I2C_NOT_SUPPORTED | La salida de vídeo identificada por VidPnTargetId no tiene un bus I2C. |
| STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST | Ningún dispositivo reconoció la dirección I2C proporcionada en SevenBitI2CAddress. Esto podría significar que ningún dispositivo del bus I2C tiene la dirección especificada o que se produjo un error cuando se transmitía la dirección. |
| STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA | La dirección I2C se transmitió correctamente, pero se produjo un error al transmitir datos al dispositivo I2C. |
Comentarios
El destino de vídeo presente identificado por VidPnTargetId está asociado a una de las salidas de vídeo en el adaptador de pantalla. Los datos se transmiten a un dispositivo I2C en el monitor que está conectado a esa salida de vídeo.
DxgkDdiI2CTransmitDataToDisplay es responsable de indicar la condición de inicio I2C, enviar la dirección I2C, enviar los datos en el búfer, comprobar las confirmaciones del receptor y señalar la condición de detención. Para obtener más información sobre el bus I2C, consulta la especificación de bus I2C, publicada por Philips Semiconductors. La especificación define un protocolo para iniciar la comunicación I2C, leer y escribir bytes en la línea de datos I2C y finalizar la comunicación I2C.
DxgkDdiI2CTransmitDataToDisplay es necesario para transmitir datos a un dispositivo I2C que tenga la dirección 0x6E, pero se le permite denegar la transmisión de datos a cualquier dispositivo I2C que tenga una dirección diferente.
DxgkDdiI2CTransmitDataToDisplay puede bloquearse si otra parte del controlador de minipuerto de pantalla o el hardware de gráficos usa el bus I2C del monitor especificado. También se permite bloquear si el controlador de minipuerto de pantalla usa el bus I2C para enviar o recibir datos de Protección de contenido digital (HDCP) de alto ancho de banda.
Si el adaptador de pantalla admite HDCP, la función DxgkDdiI2CTransmitDataToDisplay debe rechazar enviar datos a un dispositivo I2C si el dispositivo tiene una dirección I2C que usa HDCP.
DxgkDdiI2CTransmitDataToDisplay nunca debe transmitir datos a un dispositivo I2C en el adaptador de pantalla. Es decir, esta función puede transmitir datos a un dispositivo I2C en un monitor conectado al adaptador de pantalla, pero no a un dispositivo I2C que se encuentra en el propio adaptador de pantalla.
DxgkDdiI2CTransmitDataToDisplay debe ser paginable.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h (incluir Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |