Sdílet prostřednictvím

Ladění ovladače čipové karty

Poznámka:

Zaškrtnuté buildy byly k dispozici ve starších verzích Windows před Windows 10 verze 1803. Pomocí nástrojů, jako jsou Driver Verifier a GFlags, zkontrolujte kód ovladače v novějších verzích Windows.

Knihovny ovladačů čipové karty podporují několik funkcí ladění. Každá funkce ladění je reprezentována jednou z následujících konstant, které jsou definovány v souboru hlavičky Smclib.h:

DEBUG_IOCTL
DEBUG_ATR
DEBUG_PROTOCOL
DEBUG_DRIVER
DEBUG_TRACE
DEBUG_ERROR
DEBUG_BREAK
DEBUG_ALL

Kombinovaná sada povolených funkcí ladění je reprezentována hodnotou nazvanou úroveň ladění. Tuto hodnotu můžete vypočítat, když použijete bitový OR konstant odpovídajících funkcím, které chcete povolit.

Úroveň ladění můžete nastavit dvěma způsoby. Nejprve můžete použít testovací program ovladače čipové karty, Scdrvtst, který je součástí sady Windows Driver Kit (WDK). Druhým je použití SmartcardSetDebugLevel rutiny knihovny ovladačů čipové karty.

V obou případech musíte předat hodnotu úrovně ladění programu nebo rutině, která nastaví tuto úroveň. Pokud například chcete nastavit úroveň ladění z ovladače pomocí rutiny knihovny čipových karet, proveďte následující volání:

SmartcardSetDebugLevel(DebugLevel);

Chcete-li zapisovat ladicí zprávy z ovladače čtečky, musí ovladač volat následující rutinu:

SmartcardDebug(
 ULONG DebugLevel,
 PCHAR Message
);

Důležité

Chcete-li získat zprávy o ladění, musíte nainstalovat kontrolovanou verzi operačního systému a kontrolovanou verzi ovladače.

Tuto rutinu lze také použít k zápisu zpráv do vzdáleného ladicího programu následujícími způsoby.

  • K zápisu chybových zpráv použijte konstantu DEBUG_ERROR pro DebugLevel.

  • Pokud chcete psát standardní zprávy ovladače, použijte konstantu DEBUG_DRIVER.

  • Chcete-li zapisovat trasovací zprávy, které označují, kdy ovladač čtečky vstoupí nebo ukončí rutinu, použijte DEBUG_TRACE jako DebugLevel.

Při vývoji ovladače použijte zkontrolovanou verzi knihovny ovladače čipové karty a nastavte úroveň ladění na maximum pomocí SmartcardSetDebugLevel(DEBUG_ALL) ve své rutině DriverEntry.

Informace o nastavení relace vzdálené ladění naleznete v tématu Ladění systému Windows.

  • Last updated on