Kata kunci INF standar untuk tanda waktu paket NDIS
File INF dapat menentukan kata kunci INF standar berikut untuk mengaktifkan atau menonaktifkan kemampuan tanda waktu yang didukung driver miniport dan perangkat keras NIC.
Driver Miniport dapat menggunakan kata kunci ini untuk menentukan konfigurasi kemampuan tanda waktu saat ini. Misalnya, driver dapat membaca nilai kata kunci ini selama inisialisasi untuk menentukan kemampuan tanda waktu mana yang diaktifkan dan oleh karena itu driver dapat menggunakan.
*PtpHardwareTimestamp Kata kunci INF
*SoftwareTimestamp Kata kunci INF
Untuk informasi selengkapnya tentang kata kunci INF standar, lihat Kata Kunci INF Standar untuk Perangkat Jaringan.
*Kata kunci INF PtpHardwareTimestamp
Kata kunci *PtpHardwareTimestamp didefinisikan untuk mengaktifkan atau menonaktifkan dukungan untuk tanda waktu perangkat keras untuk paket Precision Time Protocol (PTP) versi 2 menggunakan UDP sebagai transportasi.
Pengaturan default untuk kata kunci *PtpHardwareTimestamp dinonaktifkan dan driver miniport harus menonaktifkan semua jenis dukungan tanda waktu perangkat keras di perangkat keras NIC secara default.
Driver Miniport membaca nilai kata kunci *PtpHardwareTimestamp untuk menentukan apakah tanda waktu perangkat keras saat ini diaktifkan atau dinonaktifkan.
Jika *PtpHardwareTimestamp diaktifkan, driver miniport harus:
Aktifkan kemampuan tanda waktu perangkat keras yang relevan di perangkat keras NIC.
Hasilkan indikasi status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG untuk melaporkan kemampuan tanda waktu yang diaktifkannya ke NDIS. Driver menggunakan struktur NDIS_TIMESTAMP_CAPABILITIES untuk menentukan kemampuan mana yang diaktifkannya. Bendera dalam bidang TimestampFlags dalam struktur NDIS_TIMESTAMP_CAPABILITIES yang sesuai dengan tanda waktu perangkat keras adalah
PtpV2OverUdpIPv4EventMsgReceiveHw, , ,PtpV2OverUdpIPv4AllMsgReceiveHwPtpV2OverUdpIPv4AllMsgTransmitHwPtpV2OverUdpIPv4EventMsgTransmitHw,PtpV2OverUdpIPv6EventMsgReceiveHw,PtpV2OverUdpIPv6AllMsgReceiveHwPtpV2OverUdpIPv6EventMsgTransmitHw, ,PtpV2OverUdpIPv6AllMsgTransmitHw,AllReceiveHw, dan .AllTransmitHwTaggedTransmitHwBidang CrossTimestamp dalam struktur NDIS_TIMESTAMP_CAPABILITIES untuk status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG menunjukkan apakah tanda waktu silang perangkat keras diaktifkan.
Ketika *PtpHardwareTimestamp diaktifkan, miniport harus mengaktifkan beberapa bentuk kemampuan untuk menghasilkan tanda waktu perangkat keras untuk Rx dan Tx untuk PTP versi 2 melalui UDP. Miniport juga harus mengaktifkan kemampuan tanda waktu silang perangkat keras jika perangkat keras mendukungnya.
Kemampuan tanda waktu perangkat keras tertentu yang harus diaktifkan driver miniport di perangkat keras tergantung pada kemampuan perangkat keras NIC. Misalnya, jika perangkat keras NIC hanya mendukung PtpV2OverUDPIPv4EventMsgReceiveHwkemampuan , dan PtpV2OverUDPIPv6EventMsgReceiveHwTaggedTransmitHw , maka miniport dapat mengaktifkan kemampuan tanda waktu perangkat keras ini jika kata kunci *PtpHardwareTimestamp diaktifkan.
Jika perangkat keras NIC mendukung beberapa bentuk kemampuan tanda waktu perangkat keras yang dapat mengaktifkan skenario PTP versi 2 melalui UDP, maka IHV harus mempertimbangkan perangkat keras dan masalah mereka seperti dampak performa untuk memutuskan kemampuan mana yang harus diaktifkan miniport. Misalnya, perangkat keras mungkin mampu menghasilkan tanda waktu untuk AllTransmitHw dan TaggedTransmitHw. Jika menyalakan AllTransmitHw lebih mahal daripada menyalakan TaggedTransmitHw, maka IHV dapat memilih untuk hanya mengaktifkan TaggedTransmitHw kemampuan untuk Tx.
Dalam semua kasus, driver miniport harus secara akurat melaporkan kemampuan tanda waktu perangkat keras mana yang diaktifkan atau dinonaktifkan menggunakan indikasi status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG .
Catatan
PTP melalui Ethernet mentah tidak didukung. IHV perlu menentukan cara paling efisien dalam menangani PTP melalui paket Ethernet mentah saat mendukung PTP melalui UDP diaktifkan.
Catatan
Tidak diperlukan dukungan untuk PTP versi 1. Jika perangkat keras NIC juga mendukung PTP versi 1, maka IHV perlu menentukan cara paling efisien dalam menangani paket PTP versi 1 saat mendukung PTP versi 2.
Entri INF untuk *PtpHardwareTimestamp
Kata kunci INF *PtpHardwareTimestamp adalah kata kunci enumerasi. Kata kunci INF standar enumerasi memiliki atribut berikut:
SubkeyName: Nama kata kunci yang harus Anda tentukan dalam file INF.
ParamDesc: Teks tampilan yang terkait dengan SubkeyName.
Nilai: Nilai bilangan bulat enumerasi yang terkait dengan setiap SubkeyName dalam daftar.
EnumDesc: Teks tampilan yang terkait dengan setiap nilai yang muncul di menu.
Default: Nilai default untuk menu.
Tabel berikut ini menjelaskan kemungkinan entri INF untuk kata kunci INF *PtpHardwareTimestamp .
| SubkeyName | ParamDesc | Nilai | EnumDesc |
|---|---|---|---|
| *PtpHardwareTimestamp | Tanda Waktu Perangkat Keras PTP | 0 (Default) | Nonaktif |
| 1 | Aktif |
Catatan
Jika driver miniport menemukan nilai yang tidak didukung untuk kata kunci *PtpHardwareTimestamp , maka itu harus menonaktifkan kemampuan tanda waktu perangkat keras sepenuhnya.
*Kata kunci INF SoftwareTimestamp
Kata kunci *SoftwareTimestamp sesuai dengan jenis tanda waktu perangkat lunak yang mampu dilakukan driver miniport. Driver miniport menggunakan nilai yang dikonfigurasi untuk kata kunci ini untuk menentukan kemampuan tanda waktu perangkat lunak mana yang didukung yang saat ini diaktifkan.
Pengaturan default untuk kata kunci *SoftwareTimestamp dinonaktifkan dan semua jenis dukungan tanda waktu perangkat lunak di miniport harus dinonaktifkan secara default.
Miniport menghasilkan indikasi status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG untuk memberi tahu NDIS tentang berbagai kemampuan tanda waktu yang saat ini diaktifkan.
Bendera dalam bidang TimestampFlags dalam struktur NDIS_TIMESTAMP_CAPABILITIES yang sesuai dengan tanda waktu perangkat lunak adalah AllReceiveSw, AllTransmitSw dan TaggedTransmitSw.
Jika kata kunci *SoftwareTimestamp berisi nilai yang menunjukkan bahwa beberapa konfigurasi tanda waktu perangkat lunak diaktifkan, maka miniport harus mengaktifkan kemampuan tanda waktu perangkat lunak yang dikonfigurasi dan menghasilkan indikasi status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG yang secara akurat melaporkan kemampuan tanda waktu perangkat lunak mana yang telah diaktifkan.
Jika miniport tidak mendukung jenis tanda waktu perangkat lunak apa pun, maka kata kunci *SoftwareTimestamp tidak boleh disertakan dalam file INF-nya.
Kata kunci *SoftwareTimestamp INF adalah kata kunci enumerasi. Kata kunci INF standar enumerasi memiliki atribut berikut:
SubkeyName: Nama kata kunci yang harus Anda tentukan dalam file INF.
ParamDesc: Teks tampilan yang terkait dengan SubkeyName.
Nilai: Nilai bilangan bulat enumerasi yang terkait dengan setiap SubkeyName dalam daftar.
EnumDesc: Teks tampilan yang terkait dengan setiap nilai yang muncul di menu.
Default: Nilai default untuk menu.
Tabel berikut ini menjelaskan kemungkinan entri INF untuk kata kunci INF *SoftwareTimestamp .
| SubkeyName | ParamDesc | Nilai | EnumDesc |
|---|---|---|---|
| *SoftwareTimestamp | Tanda Waktu Perangkat Lunak | 0 (Default) | Nonaktif |
| 1 | RxAll: Nilai enum ini sesuai dengan kemampuan driver miniport untuk menghasilkan tanda waktu perangkat lunak untuk semua paket selama Rx. | ||
| 2 | TxAll: Nilai enum ini sesuai dengan kemampuan driver miniport untuk menghasilkan tanda waktu perangkat lunak untuk semua paket selama Tx. | ||
| 3 | RxAll & TxAll: Nilai enum ini sesuai dengan kemampuan driver miniport untuk menghasilkan tanda waktu perangkat lunak untuk semua paket selama Rx dan Tx. | ||
| 4 | TaggedTx: Nilai enum ini sesuai dengan kemampuan driver miniport untuk menghasilkan tanda waktu perangkat lunak untuk paket Tx tertentu ketika ditunjukkan untuk melakukannya oleh sistem operasi. | ||
| 5 | RxAll & TaggedTx: Nilai enum ini sesuai dengan kemampuan driver miniport untuk menghasilkan tanda waktu perangkat lunak untuk semua paket selama Rx dan untuk paket Tx tertentu ketika ditunjukkan untuk melakukannya oleh sistem operasi. |
Catatan
Jika driver miniport menemukan nilai yang tidak didukung untuk kata kunci *SoftwareTimestamp , maka itu harus menonaktifkan kemampuan tanda waktu perangkat lunak sepenuhnya.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk