PPARALLEL_SET_CHIP_MODE Rückruffunktion (parallel.h)

2025-02-07

Die PPARALLEL_SET_CHIP_MODE-typed callback routine legt den Betriebsmodus eines parallelen Ports fest. Der vom System bereitgestellte Funktionstreiber für parallele Ports liefert diese Routine.

Syntax

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

NTSTATUS PparallelSetChipMode(
  [in] PVOID SetChipContext,
  [in] UCHAR ChipMode
)
{...}

Parameter

[in] SetChipContext

Zeiger auf die Geräteerweiterung des funktionalen Geräteobjekts eines parallelen Ports (FDO-).

[in] ChipMode

Gibt den Betriebsmodus eines parallelen Ports an. (Weitere Informationen zu Betriebsmodi finden Sie in den Modi, die für das Register für erweiterte Funktionen (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 angegebene Betriebsmodus wurde festgelegt.
STATUS_INVALID_DEVICE_STATE	Der Modus wird nicht gelöscht.
STATUS_NO_SUCH_DEVICE	Der angegebene Betriebsmodus ist ungültig.

Bemerkungen

Um einen Zeiger auf den vom System bereitgestellten PPARALLEL_SET_CHIP_MODE Rückruf abzurufen, verwendet ein Kernelmodustreiber eine IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO Anforderung, die eine PARALLEL_PNP_INFORMATION Struktur zurückgibt. Der TrySetChipMode Member der PARALLEL_PNP_INFORMATION-Struktur ist ein Zeiger auf diesen Rückruf.

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

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

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