DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY função de retorno de chamada (dispmprt.h)
A função de retorno de chamada DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY transmite dados para um dispositivo I2C em um monitor.
Sintaxe
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
Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporto de exibição anteriormente forneceu esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX.
[in] VidPnTargetId
Um inteiro que identifica um dos destinos presentes do vídeo no adaptador de exibição.
[in] SevenBitI2CAddress
O endereço do dispositivo I2C para o qual os dados serão transmitidos.
[in] DataLength
O comprimento, em bytes, dos dados a serem transmitidos. Esse parâmetro deve estar entre 1 e 64, inclusive.
[in] Data
Um ponteiro para um buffer que contém os dados a serem transmitidos.
Valor de retorno
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h. A lista a seguir fornece alguns dos códigos de erro possíveis que podem ser retornados.
| Código de retorno | Descrição |
|---|---|
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Não há nenhum monitor conectado à saída de vídeo identificada por VidPnTargetId. |
| STATUS_GRAPHICS_I2C_NOT_SUPPORTED | A saída de vídeo identificada por VidPnTargetId não tem um barramento I2C. |
| STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST | Nenhum dispositivo reconheceu o endereço I2C fornecido em SevenBitI2CAddress. Isso pode significar que nenhum dispositivo no barramento I2C tem o endereço especificado ou que ocorreu um erro quando o endereço foi transmitido. |
| STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA | O endereço I2C foi transmitido com êxito, mas houve um erro ao transmitir dados para o dispositivo I2C. |
Observações
O destino presente do vídeo identificado por VidPnTargetId está associado a uma das saídas de vídeo no adaptador de exibição. Os dados são transmitidos para um dispositivo I2C no monitor que está conectado a essa saída de vídeo.
DxgkDdiI2CTransmitDataToDisplay é responsável por sinalizar a condição de início do I2C, enviar o endereço I2C, enviar os dados no buffer, verificar confirmações do receptor e sinalizar a condição de parada. Para obter detalhes sobre o ônibus I2C, consulte o de Especificação do Barramento I2C, publicado pela Philips Semiconductors. A especificação define um protocolo para iniciar a comunicação I2C, ler e gravar bytes na linha de dados I2C e encerrar a comunicação I2C.
DxgkDdiI2CTransmitDataToDisplay é necessário para transmitir dados para um dispositivo I2C que tenha 0x6E de endereço, mas tem permissão para se recusar a transmitir dados para qualquer dispositivo I2C que tenha um endereço diferente.
DxgkDdiI2CTransmitDataToDisplay tiver permissão para bloquear se outra parte do driver de miniporto de exibição ou hardware gráfico estiver usando o barramento I2C do monitor especificado. Também é permitido bloquear se o driver de miniporto de exibição estiver usando o barramento I2C para enviar ou receber dados hdcp (Proteção de Conteúdo Digital de Alta Largura de Banda).
Se o adaptador de exibição der suporte ao HDCP, a função DxgkDdiI2CTransmitDataToDisplay deverá se recusar a enviar dados para um dispositivo I2C se o dispositivo tiver um endereço I2C usado pelo HDCP.
DxgkDdiI2CTransmitDataToDisplay nunca deve transmitir dados para um dispositivo I2C no adaptador de exibição. Ou seja, essa função pode transmitir dados para um dispositivo I2C em um monitor conectado ao adaptador de exibição, mas não a um dispositivo I2C que está no próprio adaptador de exibição.
DxgkDdiI2CTransmitDataToDisplay deve ser tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |