PPARALLEL_SET_CHIP_MODE Rückruffunktion (parallel.h)

Artikel
03/01/2024

Die PPARALLEL_SET_CHIP_MODE typisierte Rückrufroutine legt den Betriebsmodus eines parallelen Ports fest. Der vom System bereitgestellte Funktionstreiber für parallele Ports stellt diese Routine bereit.

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 (Functional Device Object, FDO) eines parallelen Ports.

[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.

Hinweise

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. Das TrySetChipMode-Element 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 Aufrufer zuerst den aktuellen Modus löschen.

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