Freigeben über


Verwenden von MakeCat zum Erstellen einer Katalogdatei

Sie können das MakeCat-Tool verwenden, um eine Katalogdatei zu erstellen.

Sie müssen das MakeCat-Tool nur verwenden, um Katalogdateien für Dateien zu erstellen, die nicht mithilfe einer INF-Datei installiert werden. Wenn die Dateien mithilfe einer INF-Datei installiert werden, verwenden Sie das Inf2Cat-Tool , um die Katalogdatei zu erstellen. Inf2Cat schließt automatisch alle Dateien im Treiberpaket ein, auf die in der INF-Datei des Pakets verwiesen wird. Weitere Informationen zur Verwendung des Inf2Cat-Tools finden Sie unter Verwenden von Inf2Cat zum Erstellen einer Katalogdatei.

Hinweis

 Für alle Binärdateien im Kernelmodus, bei denen es sich um einen Starttreiber handelt, sollten Sie auch eine Signatur in die Binärdatei einbetten. Weitere Informationen zu diesem Verfahren finden Sie unter Testen des Signierens eines Treibers über eine eingebettete Signatur.

Um eine Katalogdatei zu erstellen, müssen Sie zunächst manuell eine Katalogdefinitionsdatei (CDF) erstellen, die die Katalogheaderattribute und Dateieinträge beschreibt. Sobald diese Datei erstellt wurde, können Sie das MakeCat-Tool ausführen, um eine Katalogdatei zu erstellen. Das MakeCat-Tool führt folgendes aus, wenn es die CDF-Datei verarbeitet:

  • Überprüft die Liste der Attribute für jede Datei, die in der CDF-Datei aufgeführt ist.

  • Fügt der Katalogdatei die aufgelisteten Attribute hinzu.

  • Generiert einen kryptografischen Hash oder Fingerabdruck jeder der aufgelisteten Dateien.

  • Speichert den Fingerabdruck jeder Datei in der Katalogdatei.

In diesem Thema wird beschrieben, wie Sie eine CDF-Datei für die 64-Bit-Kernelmodus-Binärdateien des ToastPkg-Beispieltreiberpakets erstellen. Innerhalb des WDK-Installationsverzeichnisses befinden sich diese Binärdateien im Verzeichnis src\general\toaster\toastpkg\toastcd\amd64 .

Gehen Sie wie folgt vor, um eine CDF-Datei für das ToastPkg-Beispieltreiberpaket zu erstellen:

  1. Starten Sie Editor, und kopieren Sie den Text aus dem folgenden Beispiel. Sie enthält die Liste der zu katalogisierenden Dateien sowie deren Attribute.

    [CatalogHeader]
    Name=tstamd64.cat
    PublicVersion=0x0000001
    EncodingType=0x00010001
    CATATTR1=0x10010001:OSAttr:2:6.0
    [CatalogFiles]
    <hash>File1=amd64\toaster.pdb
    <hash>File2=amd64\toaster.sys
    <hash>File3=amd64\toastva.exe
    <hash>File4=amd64\toastva.pdb
    <hash>File5=amd64\tostrcls.dll
    <hash>File6=amd64\tostrcls.pdb
    <hash>File7=amd64\tostrco2.dll
    <hash>File8=amd64\tostrco2.pdb
    
  2. Speichern Sie die Datei als tstamd64.cdf im selben Ordner wie das Treiberpaket. Hinweis Erstellen Sie beim Erstellen eines Treibers für mehrere Plattformen eine separate Katalogdatei für jede Plattform.

Die folgende Befehlszeile zeigt, wie Sie mithilfe der Datei tstamd64.cdf eine Katalogdatei über das MakeCat-Tool erstellen:

makecat -v tstamd64.cdf

Nachdem Sie das Tool ausgeführt haben, wird eine Datei mit dem Namen tstamd64.cat erstellt.

Weitere Informationen zum MakeCat-Tool und seinen Befehlszeilenargumenten finden Sie auf der Website Verwenden von MakeCat .

Weitere Informationen zur Verwendung des MakeCat-Tools finden Sie unter Erstellen einer Katalogdatei für ein Nicht-PnP-Treiberpaket.