PPARALLEL_WRITE Rückruffunktion (parallel.h)

Die PPARALLEL_WRITE-Typ-Rückrufroutine schreibt Daten auf ein paralleles Gerät. Der vom System bereitgestellte Bustreiber für parallele Ports liefert diese Routine.

Syntax

PPARALLEL_WRITE PparallelWrite;

NTSTATUS PparallelWrite(
  [in]  PVOID Context,
  [in]  PVOID Buffer,
  [in]  ULONG NumBytesToWrite,
  [out] PULONG NumBytesWritten,
  [in]  UCHAR Channel
)
{...}

Parameter

[in] Context

Zeiger auf die Geräteerweiterung des physischen Geräteobjekts eines parallelen Geräts (PDO-).

[in] Buffer

Zeiger auf einen vom Aufrufer zugewiesenen Schreibpuffer.

[in] NumBytesToWrite

Gibt die Anzahl der Bytes an, die vom Schreibpuffer auf das parallele Gerät kopiert werden sollen. Muss kleiner oder gleich der Anzahl der Bytes im vom Aufrufer zugewiesenen Schreibpuffer sein.

[out] NumBytesWritten

Gibt die Anzahl der Bytes an, die tatsächlich aus dem vom Aufrufer zugewiesenen Schreibpuffer auf das parallele Gerät kopiert wurden.

[in] Channel

Wird nicht verwendet.

Rückgabewert

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die vom Anrufer bereitgestellten Daten wurden erfolgreich an das Gerät übertragen.
STATUS_Xxx-	Ein interner Vorgang führte zu einem NTSTATUS-Fehler.

Bemerkungen

Um einen Zeiger auf den vom System bereitgestellten PPARALLEL_WRITE Rückruf abzurufen, verwendet ein Kernelmodustreiber eine IOCTL_INTERNAL_PARCLASS_CONNECT Anforderung, die eine PARCLASS_INFORMATION Struktur zurückgibt. Das ParallelWrite Member der PARCLASS_INFORMATION-Struktur ist ein Zeiger auf diesen Rückruf.

Ein Client kann diese Routine nur verwenden, wenn er über eine Sperre für einen parallelen Port verfügt. Ein Client ruft eine Sperre für einen parallelen Port mithilfe einer IOCTL_INTERNAL_LOCK_PORT Anforderung ab.

Der PPARALLEL_WRITE Rückruf wird im Thread des Aufrufers an der IRQL des Aufrufers ausgeführt.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	parallel.h (include Parallel.h)

Siehe auch

PPARALLEL_READ

IOCTL_INTERNAL_LOCK_PORT