PPARALLEL_CLEAR_CHIP_MODE Rückruffunktion (parallel.h)

Artikel
02/26/2024

Die PPARALLEL_CLEAR_CHIP_MODE typisierte Rückrufroutine löscht den Betriebsmodus eines parallelen Ports, indem der Kommunikationsmodus des Hostchipsets auf den IEEE 1284-Kompatibilitätsmodus zurückgesetzt wird. Der vom System bereitgestellte Funktionstreiber für parallele Ports stellt diese Routine bereit.

Syntax

PPARALLEL_CLEAR_CHIP_MODE PparallelClearChipMode;

NTSTATUS PparallelClearChipMode(
  [in] PVOID ClearChipContext,
  [in] UCHAR ChipMode
)
{...}

Parameter

[in] ClearChipContext

Zeiger auf die Geräteerweiterung des funktionalen Geräteobjekts (Functional Device Object, FDO) eines parallelen Ports.

[in] ChipMode

Gibt den aktuellen Betriebsmodus des parallelen Ports an.

Weitere Informationen zu Betriebsmodi finden Sie in den Modi, die für das erweiterte Funktionsregister (Enhanced Capabilities Register, ECR) in der Datei parallel.h definiert sind, die im Microsoft Windows Driver Kit (WDK) enthalten ist.

Rückgabewert

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Betriebsmodus wurde auf IEEE 1284-Kompatibilitätsmodus festgelegt.
STATUS_INVALID_DEVICE_STATE	Der angegebene Modus stimmt nicht mit dem aktuellen Modus überein.

Hinweise

Um einen Zeiger auf den vom System bereitgestellten PPARALLEL_CLEAR_CHIP_MODE Rückruf zu erhalten, verwendet ein Kernelmodustreiber eine IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO-Anforderung , die eine PARALLEL_PNP_INFORMATION-Struktur zurückgibt. Das ClearChipMode-Element der PARALLEL_PNP_INFORMATION-Struktur ist ein Zeiger auf diesen Rückruf.

Ein Aufrufer verwendet den PPARALLEL_CLEAR_CHIP_MODE Rückruf in Verbindung mit dem PPARALLEL_SET_CHIP_MODE Rückruf.

Um einen Modus festzulegen, muss ein Aufrufer zuerst den aktuellen Modus löschen.

Weitere Informationen finden Sie unter Festlegen und Löschen des Kommunikationsmodus für einen ParallelPort.