PPARALLEL_TRY_ALLOCATE_ROUTINE Rückruffunktion (parallel.h)

Artikel
02/27/2024

Die PPARALLEL_TRY_ALLOCATE_ROUTINE typisierte Rückrufroutine (ISR) versucht, einen parallelen Port unter IRQL = DIRQL zuzuweisen. Der vom System bereitgestellte Funktionstreiber für parallele Ports stellt diese Routine bereit.

Syntax

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

BOOLEAN PparallelTryAllocateRoutine(
  [in] PVOID TryAllocateContext
)
{...}

Parameter

[in] TryAllocateContext

Zeiger auf die Geräteerweiterung eines funktionalen Geräteobjekts, das einen parallelen Port darstellt.

Rückgabewert

Rückgabecode	Beschreibung
TRUE	Der parallele Port wurde zugeordnet.
FALSE	Der parallele Port wurde nicht zugeordnet.

Hinweise

Ein Kernelmodustreiber verbindet eine Interruptdienstroutine mithilfe einer IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT, die eine PARALLEL_INTERRUPT_INFORMATION-Struktur zurückgibt. Diese Struktur enthält den TryAllocatePortAtInterruptLevel-Member , der ein Zeiger auf den vom System bereitgestellten PPARALLEL_TRY_ALLOCATE_ROUTINE -Rückruf (ISR) ist.

Der PPARALLEL_TRY_ALLOCATE_ROUTINE-Rückruf (ISR) ist nicht blockiert, stellt keine Zuordnungsanforderung in die Warteschlange und gibt sofort zurück.

Ein Treiber verwendet den PPARALLEL_TRY_ALLOCATE_ROUTINE -Rückruf (ISR) in Verbindung mit einer vom Treiber bereitgestellten ISR. Wenn dem Treiber kein paralleler Port zugewiesen ist, wenn die ISR des Treibers aufgerufen wird, kann der Treiber diesen Rückruf verwenden.

Weitere Informationen zum Zuweisen eines parallelen Ports in einer ISR finden Sie unter Verbinden einer Interruptdienstroutine mit einem ParallelPort.

Hinweis Der rückruf von PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) ist nicht getestet. Microsoft empfiehlt die Verwendung einer vom Client bereitgestellten Interruptroutine nicht. Die Verwendung von Interrupts kann zu Systeminstabilität führen. Standardmäßig ist die IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT-Anforderung deaktiviert.