Freigeben über

Konfigurieren der BCD für das Debuggen

Sie können den Windows-Debugger verwenden, um Factory OS-Geräte zu debuggen. Sobald Ihr Factory OS-Gerät konfiguriert ist, ist der Debugging-Prozess derselbe wie bei anderen Windows-Versionen. Das Konfigurieren der BCD-Dateien, um das Debugging zu ermöglichen, ist jedoch aufgrund des Partitionslayouts von Speicherplätzen, das Factory OS verwendet, um die Zustandstrennung zu ermöglichen, anders.

Werkseitige OS Boot-Konfigurationsdaten (BCD)

BCD-Speicherort

Die BCD-Dateien auf Factory OS-Geräten befinden sich auf dem Volume VIRT_EFIESP, einer virtuellen Festplatte mit Lese-/Schreibzugriff. Dies ist ein Unterschied zu anderen Windows-Versionen, die die EFI-Systempartition zur Aufnahme der BCD-Dateien verwenden.

Unter Partitionslayout erfahren Sie alles über die Partitionen und virtuellen Festplatten im Partitionslayout des Factory OS Storage Spaces.

Ändern von BCD-Dateien

In anderen Versionen von Windows können Sie über die Eingabeaufforderung auf den BCD-Speicher zugreifen und ändern. Da Factory OS-Geräte keine interaktive Eingabeaufforderung haben, müssen Sie die BCD-Dateien auf VIRT_EFIESP auf folgende Weise ändern:

Da der virtuelle Datenträger, auf dem sich die BCD-Dateien befinden, schreib- und lesbar ist, können Sie, sobald Sie Zugriff auf den Datenträger haben, alle Änderungen vornehmen, die Sie auch auf jeder anderen Windows-Installation an der BCD-Datei vornehmen könnten.

Automatisierte Möglichkeiten der Debugging-Konfiguration

Verwenden des Debug-WcosDevice-Hilfsprogramms

Debug-WcosDevice ist ein PowerShell-Dienstprogramm, das im WSK enthalten ist und bei der Einrichtung des Debuggers auf Factory OS-Geräten hilft. Sie können es gegen ein eingebundenes Image oder ein Online-Image über TShell verwenden. Weitere Informationen zur Verwendung finden Sie unter Debug-WcosDevice verwenden, um das Debugging zu aktivieren.

Nachdem Sie Debug-WcosDevice zum Ändern der BCD-Dateien Ihres Factory OS verwendet haben, können Sie das Debuggen starten.

Optionale Debugging-Funktionen einschalten

Factory OS verfügt über optionale Features, die Sie in Ihrer OEMInput-Datei aktivieren können, um das BCD zu ändern, um das Debuggen zu aktivieren. Die optionalen Features sind:

Optionale Features
KDNETUSB_ON
KDNETSERIAL_ON
KDUSB_ON

Wenn Sie das Debugging mit Hilfe der optionalen Funktionen aktiviert haben, können Sie mit dem Debuggen beginnen.

Manuelles Konfigurieren des Debuggens

Bevor Sie das Debuggen konfigurieren können, wählen Sie eine Methode aus, um auf die BCD-Dateien auf einem Factory OS-Gerät zuzugreifen.

Verbinden mit TShell

Sie können auf BCD-Dateien zugreifen, indem Sie eine Verbindung mit einem ausgeführten Factory OS-Gerät mit TShell herstellen:

cmdd BCDEdit

Mit BCDEdit können Sie BCD ändern.

Verbinden mit SSH

Sie können auf BCD-Dateien zugreifen, die eine Verbindung mit einem ausgeführten Factory OS-Gerät herstellen, das SSH konfiguriert hat. Wenn Sie über SSH mit Ihrem Gerät verbunden sind:

BCDEdit

Mit BCDEdit können Sie BCD ändern.

Auf einer eingebundenen VHD

Sie können auf BCD-Dateien in der Partition VIRT_EFIESP auf einer offline gemounteten VHD zugreifen, indem Sie eine VHD auf Ihrem Techniker-PC mounten. Um eine VHD einzubinden, doppelklicken Sie im Datei-Explorer auf die VHD. Von einem Techniker-PC aus, auf dem die VHD eingebunden ist. Nachdem die VHD eingebunden wurde:

BCDEdit /store <path_to_VIRT_EFIESP_bcd>

Mit BCDEdit können Sie BCD ändern.

Ändern der BCD

Wenn Sie Debug-WcosDevice oder die optionalen Debugfeatures nicht verwenden, um die BCD zu ändern, verwenden Sie BCDEdit , um Änderungen vorzunehmen, die das Debuggen aktivieren. Informationen zum Verwenden von BCDEdit für verschiedene Debugszenarien finden Sie in der folgenden Tabelle:

Debuggertyp Einrichten des Debuggers BCDEdit-Befehle So starten Sie das Debuggen
Net Manuelles Debuggen des KDNET-Netzwerkkerns einrichten BCDEdit /debug on
BCDEdit /dbgsettings net hostip:w.x.y.z port:n key:Key		 Debuggen des Netzwerks starten
USB Manuelles Debugging im Kernel-Modus über ein USB 3.0-Kabel einrichten BCDEdit /debug on
BCDEdit /dbgsettings usb targetname:targetname		 USB-Debugging starten
Seriell Manuelles Debugging im Kernel-Modus über ein serielles Kabel einrichten BCDEdit /debug on
BCDEdit /dbgsettings serial debugport:n baudrate:rate		 Serielles Debugging starten
Hinweis: Lesen Sie das Debuggen über eine serielle Verbindung, um zu erfahren, wie Sie eine Verbindung mit einer lokalen VM über eine serielle Verbindung herstellen.

Nachdem Sie die BCD-Einstellungen auf Ihrem WCOS-Gerät geändert haben, können Sie mit dem Debuggen beginnen

Starten des Debugvorgangs

Sie können Debugsitzungen basierend auf dem Typ der Verbindung starten, die Sie zum Herstellen einer Verbindung mit Ihrem WCOS-Gerät verwenden:

Debuggertyp So starten Sie das Debuggen
Net Debuggen des Netzwerks starten
USB [USB-Debugging starten]/windows-hardware/drivers/debugger/setting-up-a-usb-3-0-debug-cable-connection#starting-a-debugging-session-for-the-first-time)
Seriell Serielles Debugging starten