DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY fungsi panggilan balik (dispmprt.h)
Fungsi panggilan balik DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY mengirimkan data ke perangkat I2C di monitor.
Sintaks
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
Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX.
[in] VidPnTargetId
Bilangan bulat yang mengidentifikasi salah satu video yang menyajikan target pada adaptor tampilan.
[in] SevenBitI2CAddress
Alamat perangkat I2C tempat data akan dikirimkan.
[in] DataLength
Panjang, dalam byte, dari data yang akan ditransmisikan. Parameter ini harus antara 1 dan 64, inklusif.
[in] Data
Penunjuk ke buffer yang menyimpan data yang akan dikirimkan.
Nilai kembali
DXGKDDI_I2C_TRANSMIT_DATA_TO_DISPLAY mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h. Daftar berikut ini memberikan beberapa kemungkinan kode kesalahan yang dapat dikembalikan.
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Tidak ada monitor yang terhubung ke output video yang diidentifikasi oleh VidPnTargetId. |
| STATUS_GRAPHICS_I2C_NOT_SUPPORTED | Output video yang diidentifikasi oleh VidPnTargetId tidak memiliki bus I2C. |
| STATUS_GRAPHICS_I2C_DEVICE_DOES_NOT_EXIST | Tidak ada perangkat yang mengakui alamat I2C yang disediakan di SevenBitI2CAddress. Ini bisa berarti bahwa tidak ada perangkat di bus I2C yang memiliki alamat yang ditentukan atau bahwa kesalahan terjadi ketika alamat dikirimkan. |
| STATUS_GRAPHICS_I2C_ERROR_TRANSMITTING_DATA | Alamat I2C berhasil ditransmisikan, tetapi ada kesalahan saat mengirimkan data ke perangkat I2C. |
Keterangan
Target sajian video yang diidentifikasi oleh VidPnTargetId dikaitkan dengan salah satu output video pada adaptor tampilan. Data ditransmisikan ke perangkat I2C di monitor yang terhubung ke output video tersebut.
DxgkDdiI2CTransmitDataToDisplay bertanggung jawab untuk memberi sinyal kondisi mulai I2C, mengirim alamat I2C, mengirim data di buffer, memeriksa pengakuan dari penerima, dan menandakan kondisi berhenti. Untuk detail tentang bus I2C, lihat Spesifikasi Bus I2C, yang diterbitkan oleh Philips Semiconductors. Spesifikasi mendefinisikan protokol untuk memulai komunikasi I2C, membaca dan menulis byte melalui baris data I2C, dan mengakhiri komunikasi I2C.
DxgkDdiI2CTransmitDataToDisplay diperlukan untuk mengirimkan data ke perangkat I2C yang memiliki alamat 0x6E tetapi diizinkan untuk menolak mengirimkan data ke perangkat I2C apa pun yang memiliki alamat berbeda.
DxgkDdiI2CTransmitDataToDisplay diizinkan untuk memblokir jika bagian lain dari driver miniport tampilan atau perangkat keras grafis menggunakan bus I2C monitor yang ditentukan. Hal ini juga diizinkan untuk memblokir jika driver miniport tampilan menggunakan bus I2C untuk mengirim atau menerima data Perlindungan Konten Digital (HDCP) bandwidth tinggi.
Jika adaptor tampilan mendukung HDCP, fungsi DxgkDdiI2CTransmitDataToDisplay harus menolak untuk mengirim data ke perangkat I2C jika perangkat memiliki alamat I2C yang digunakan oleh HDCP.
DxgkDdiI2CTransmitDataToDisplay tidak boleh mengirimkan data ke perangkat I2C pada adaptor tampilan. Artinya, fungsi ini dapat mengirimkan data ke perangkat I2C dalam monitor yang terhubung ke adaptor tampilan, tetapi tidak ke perangkat I2C yang ada di adaptor tampilan itu sendiri.
DxgkDdiI2CTransmitDataToDisplay harus dibuat dapat di-pageable.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Desktop |
| Header | dispmprt.h (termasuk Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |