TEST-COMPAT-WIN7-001: Verify Windows 7 SP1 Compatibility

[zarfld]

Test Case Information

Test ID: TEST-COMPAT-WIN7-001
Test Type: Compatibility Test
Priority: P2 (Important - Legacy Platform Support)
Test Level: System Test

Objective

Verify driver compatibility with Windows 7 SP1 (x64), including NDIS 6.20 compatibility, WDF support, and extended security update (ESU) scenarios.

Traceability

• Traces to: REQ-F-HARDWARE-QUIRKS-001: Hardware-Specific Workarounds (Errata Handling) #79 (REQ-NF-COMPAT-WIN7-001: Windows 7 SP1 Compatibility)

Test Scope

This test verifies:

1. Driver load and operation on Windows 7 SP1 (x64)
2. NDIS 6.20 compatibility (Windows 7)
3. Windows Driver Framework (KMDF 1.9+) compatibility
4. Extended Security Update (ESU) compatibility
5. SHA-2 code signing compatibility

Preconditions

• Test system: Windows 7 SP1 (x64) (Build 7601)
• Hardware: Intel I210/I219 NIC installed
• KB2999226 installed (Universal C Runtime)
• SHA-2 support installed (KB4474419, KB4490628)

Test Steps

Setup

1. Install Windows 7 SP1 (x64) on test system
2. Install required updates:

   # SHA-2 Code Signing Support
   wusa.exe Windows6.1-KB4474419-v3-x64.msu /quiet /norestart
   wusa.exe Windows6.1-KB4490628-x64.msu /quiet /norestart
   
   # Universal C Runtime
   wusa.exe Windows6.1-KB2999226-x64.msu /quiet /norestart

Execution

Test 1: Windows 7 SP1 Driver Load

1. Install driver:

   pnputil -i -a IntelAvbFilter.inf

2. Verify driver loaded:

   sc query IntelAvbFilter
   # Expected: SERVICE_RUNNING

3. Check device manager:

   devcon status "PCI\VEN_8086&DEV_15F2"  # I210

4. Expected: Driver loads successfully

Test 2: NDIS 6.20 Compatibility

1. Verify driver registers NDIS 6.20:

   // In driver source
   characteristics.MajorNdisVersion = 6;
   characteristics.MinorNdisVersion = 20;  // Windows 7

2. Test NDIS 6.20 features:
   • Receive Side Scaling (RSS)
   • Large Send Offload (LSO)
3. Run network traffic:

   iperf3 -c <server_ip> -t 60

4. Expected: NDIS features work correctly

Test 3: WDF Compatibility (KMDF 1.9)

1. Verify driver uses KMDF 1.9+ (Windows 7 compatible):

   [IntelAvbFilter_wdfsect]
   KmdfLibraryVersion = 1.9  ; Minimum for Windows 7 SP1

2. Check WDF runtime loaded:

   sc query WdfLoadMgr
   # Expected: SERVICE_RUNNING

3. Expected: WDF runtime operational

Test 4: SHA-2 Code Signing

1. Verify driver signed with SHA-2:

   Get-AuthenticodeSignature IntelAvbFilter.sys
   # Expected: SignatureAlgorithm = sha256RSA

2. Test driver load (requires KB4474419):
   • Without KB4474419: Driver SHOULD fail to load
   • With KB4474419: Driver SHOULD load successfully
3. Expected: SHA-2 signature validated

Test 5: Extended Security Update (ESU) Compatibility

1. On Windows 7 ESU system (2020-2023):
   • Install all ESU updates
   • Verify driver loads
2. Test with ESU patches:
   • ESU Year 1 (2020)
   • ESU Year 2 (2021)
   • ESU Year 3 (2022-2023)
3. Expected: Driver compatible with ESU

Test 6: Functional Testing

1. Test core IOCTL operations:

   IOCTL_PHC_GET_TIME
   IOCTL_PHC_SET_TIME
   IOCTL_PHC_ADJ_FREQ

2. Test network traffic (1 Gbps throughput):

   iperf3 -c <server_ip> -t 300
   # Expected: ~950 Mbps

3. Test PTP clock accuracy:
   • Launch clock
   • Measure drift over 1 hour
   • Expected: <100 ns drift
4. Expected: All features operational

Test 7: Legacy Hardware Compatibility

1. Test on older I210 firmware:
   • NVM Version 3.x (2014-2015)
2. Test on I219 variants:
   • I219-V (consumer)
   • I219-LM (enterprise)
3. Expected: Driver works with older firmware

Cleanup

1. Uninstall driver:

   pnputil -d IntelAvbFilter.inf

Expected Results

Pass Criteria

• ✅ Driver loads on Windows 7 SP1 (x64)
• ✅ NDIS 6.20 registered correctly
• ✅ KMDF 1.9+ compatible
• ✅ SHA-2 signature validated (with KB4474419)
• ✅ ESU compatible (if applicable)
• ✅ All IOCTLs functional

Fail Criteria

• ❌ Driver fails to load on Windows 7 SP1
• ❌ NDIS version mismatch (BSOD)
• ❌ WDF runtime incompatibility
• ❌ SHA-2 signature rejected

Test Environment

Hardware:

• Test system: Intel Core 2 Quad or later, 4GB RAM
• NIC: Intel I210/I219

Software:

• Windows 7 SP1 (x64) (Build 7601)
• KB4474419 (SHA-2 support)
• KB2999226 (UCRT)

Automation

Automation Status: Manual + Semi-Automated

Rationale for Manual: Windows 7 EOL (Jan 2020), no GitHub Actions runners available.

Semi-Automated CI:

# .github/workflows/win7-compatibility.yml
# Runs on self-hosted Windows 7 runner (if available)

name: Windows 7 Compatibility

on: [pull_request]

jobs:
  test-win7:
    runs-on: self-hosted-win7  # Custom runner
    steps:
      - uses: actions/checkout@v4
      - name: Build driver
        run: msbuild IntelAvbFilter.sln /p:Configuration=Release
      - name: Install driver
        run: pnputil -i -a IntelAvbFilter.inf
      - name: Verify loaded
        run: |
          $status = sc query IntelAvbFilter
          if ($status -notmatch "RUNNING") { exit 1 }
      - name: Run traffic test
        run: iperf3 -c ${{ secrets.PERF_SERVER_IP }} -t 60

Notes

• Windows 7 EOL: January 14, 2020 (Extended Security Updates ended Jan 2023)
• Target Market: Industrial/automotive systems with long-term Windows 7 deployments
• SHA-2 Requirement: Windows 7 requires KB4474419 for SHA-2 code signing support (August 2019+)
• Testing Priority: P2 (less critical than Windows 10/11 but still required for legacy support)

References

• REQ-NF-COMPAT-WIN7-001 (Issue REQ-F-HARDWARE-QUIRKS-001: Hardware-Specific Workarounds (Errata Handling) #79)
• NDIS 6.20: https://learn.microsoft.com/windows-hardware/drivers/network/introduction-to-ndis-6-20
• Windows 7 SHA-2 Support: https://support.microsoft.com/help/4472027

---

Created: 2025-12-19
Status: Draft
Assigned To: Compatibility Testing Team

[github-actions]

🤖 Status Sync

**Automatic status update** based on issue body:
- **Body status**: Draft
- **Previous label(s)**: (none)
- **New label**: `status:in-progress`

This sync ensures consistency between issue status and labels for tracking purposes.

---
*Automated by [project-sync.yml](.github/workflows/project-sync.yml)*

[github-actions]

🤖 Status Sync

**Automatic status update** based on issue body:
- **Body status**: Draft
- **Previous label(s)**: (none)
- **New label**: `status:in-progress`

This sync ensures consistency between issue status and labels for tracking purposes.

---
*Automated by [project-sync.yml](.github/workflows/project-sync.yml)*

[zarfld]

Closing — EOL Target OS, Outside Scope (wont-fix)

This issue requires the driver to support Windows 7 SP1.

Windows 7 reached End of Life on January 14, 2020. The IntelAvbFilter driver targets Windows 10 and later (NDIS 6.50+, WDF 1.23+). Building and testing on Windows 7 is not supported and there is no plan to do so.

Closing as not planned.