DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY funzione di callback (dispmprt.h)
La funzione di callback DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY trasmette i dati a un dispositivo I2C in un monitor.
Sintassi
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
)
{...}
Parametri
[in] MiniportDeviceContext
Handle di un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel grafico Microsoft DirectX.
[in] VidPnTargetId
Intero che identifica una delle destinazioni del video presenti nella scheda di visualizzazione.
[in] SevenBitI2CAddress
Indirizzo del dispositivo I2C a cui verranno trasmessi i dati.
[in] DataLength
Lunghezza, in byte, dei dati da trasmettere. Questo parametro deve essere compreso tra 1 e 64 inclusi.
[in] Data
Puntatore a un buffer che contiene i dati da trasmettere.
Valore restituito
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h. L'elenco seguente fornisce alcuni dei possibili codici di errore che possono essere restituiti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Non è presente alcun monitor connesso all'output video identificato da VidPnTargetId. |
| STATUS_GRAPHICS_I2C_NOT_SUPPORTED | L'output video identificato da VidPnTargetId non ha un bus I2C. |
| STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST | Nessun dispositivo riconosciuto l'indirizzo I2C fornito in SevenBitI2CAddress. Ciò potrebbe significare che nessun dispositivo nel bus I2C ha l'indirizzo specificato o che si è verificato un errore quando l'indirizzo è stato trasmesso. |
| STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA | L'indirizzo I2C è stato trasmesso correttamente, ma si è verificato un errore durante la trasmissione dei dati al dispositivo I2C. |
Commenti
Il video presente destinazione identificato da VidPnTargetId è associato a uno degli output video nella scheda di visualizzazione. I dati vengono trasmessi a un dispositivo I2C nel monitor connesso all'output video.
DxgkDdiI2CTransmitDataToDisplay è responsabile della segnalazione della condizione di avvio I2C, dell'invio dell'indirizzo I2C, dell'invio dei dati nel buffer, della verifica della presenza di riconoscimenti dal ricevitore e della segnalazione della condizione di arresto. Per informazioni dettagliate sul bus I2C, vedere la specifica del bus I2C, pubblicata da Philips Semiconduttors. La specifica definisce un protocollo per avviare la comunicazione I2C, leggere e scrivere byte sulla riga di dati I2C e terminare la comunicazione I2C.
DxgkDdiI2CTransmitDataToDisplay è necessario per trasmettere i dati a un dispositivo I2C con indirizzo 0x6E, ma è autorizzato a rifiutare di trasmettere dati a qualsiasi dispositivo I2C con un indirizzo diverso.
DxgkDdiI2CTransmitDataToDisplay è autorizzato a bloccare se un'altra parte del driver miniport di visualizzazione o dell'hardware grafico usa il bus I2C del monitor specificato. È anche consentito bloccare se il driver miniport dello schermo usa il bus I2C per inviare o ricevere dati HDCP (High-Bandwidth Digital Content Protection).
Se la scheda di visualizzazione supporta HDCP, la funzione DxgkDdiI2CTransmitDataToDisplay deve rifiutare di inviare dati a un dispositivo I2C se il dispositivo ha un indirizzo I2C usato da HDCP.
DxgkDdiI2CTransmitDataToDisplay non deve mai trasmettere dati a un dispositivo I2C nella scheda di visualizzazione. Ovvero, questa funzione può trasmettere dati a un dispositivo I2C in un monitor connesso alla scheda di visualizzazione, ma non a un dispositivo I2C che si trova sulla scheda di visualizzazione stessa.
DxgkDdiI2CTransmitDataToDisplay deve essere reso pageable.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |