NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG

發行項
06/15/2023

迷你埠驅動程式會使用 NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG 狀態指示，將 NIC 硬體和迷你埠驅動程式的目前時間戳記組態回報給 NDIS 和過度配置驅動程式。

此狀態指示代表目前啟用或停用的時間戳記功能。如需狀態指示驅動程式用來報告時間戳記功能的資訊，請參閱 NDIS_STATUS_TIMESTAMP_CAPABILITY。

備註

在初始化期間，迷你埠驅動程式應該會從 其 MiniportInitializeEx 函式中指出目前的時間戳記設定。驅動程式應該：

使用目前的時間戳記組態 ，初始化NDIS_TIMESTAMP_CAPABILITIES 結構。驅動程式會設定 NDIS_TIMESTAMP_CAPABILITIES 結構的成員，如下所示：
- 驅動程式會使用 TimestampFlags 欄位來指出其目前的時間戳記設定。如果目前啟用對應的時間戳記功能，則 NDIS_TIMESTAMP_CAPABILITY_FLAGS 結構中的每個旗標都應該設定為 TRUE ，否則為 FALSE 。
注意

若要判斷目前啟用或停用哪些時間戳記功能，迷你埠會讀取時間戳記相關關鍵字 *PtpHardwareTimestamp 和 *SoftwareTimestamp的目前值。如需使用這些關鍵字並判斷要啟用哪些時間戳記功能的詳細資訊，請參閱 NDIS 封包時間戳記的標準化 INF 關鍵字。

注意

如果實作同時尋找透過關鍵字啟用的硬體和軟體時間戳記，則迷你埠應該只啟用硬體時間戳記，而且應該停用軟體時間戳記。
- 如果目前設定中已啟用硬體交叉時間戳記，則驅動程式應將 CrossTimestamp 欄位設定為 TRUE ，否則為 FALSE 。
- HardwareClockFrequencyHz欄位必須包含 NIC 硬體時鐘的目前作業頻率。
- [標頭] 欄位中的[類型] 欄位應該設定為[NDIS_OBJECT_TYPE_DEFAULT]，並將 [修訂] 設定為[NDIS_TIMESTAMP_CAPABILITIES_REVISION_1]。
呼叫NdisMIndicateStatusEx來報告目前的設定，以產生NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG狀態指示。 NDIS_STATUS_INDICATION結構的StatusBuffer欄位應該指向初始化NDIS_TIMESTAMP_CAPABILITIES結構。

迷你埠驅動程式必須至少產生 一次NDIS_STATUS_TIMESTAMP_CAPABILITY 指示，才能指出 NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG。否則，NDIS 會拒絕 NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG 狀態指示，且不會對過度運作的驅動程式表示。

如果迷你埠驅動程式使用NDIS_STATUS_TIMESTAMP_CAPABILITY狀態 (指示來指出 NIC 硬體時間戳記功能的變更，例如，NDIS_TIMESTAMP_CAPABILITIES 結構中的HardwareClockFrequencyHz欄位中的變更，因為 NIC 硬體) 的基礎變更，則它也必須使用NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG報告目前組態中的對應變更狀態指示。

每當迷你埠驅動程式偵測到目前時間戳記組態的變更時，也必須產生 NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG 狀態指示。