PPARALLEL_TRY_ALLOCATE_ROUTINE funzione di callback (parallel.h)

Articolo
02/07/2025

La routine di callback PPARALLEL_TRY_ALLOCATE_ROUTINE-typed (ISR) tenta di allocare una porta parallela in IRQL = DIRQL. Il driver di funzione fornito dal sistema per le porte parallele fornisce questa routine.

Sintassi

PPARALLEL_TRY_ALLOCATE_ROUTINE PparallelTryAllocateRoutine;

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

Parametri

[in] TryAllocateContext

Puntatore all'estensione del dispositivo di un oggetto dispositivo funzionale che rappresenta una porta parallela.

Valore restituito

Codice restituito	Descrizione
TRUE	La porta parallela è stata allocata.
false	La porta parallela non è stata allocata.

Osservazioni

Un driver in modalità kernel connette una routine del servizio interrupt usando un IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT, che restituisce una struttura PARALLEL_INTERRUPT_INFORMATION. Questa struttura include il membro tryAllocatePortAtInterruptLevel, che è un puntatore al callback di PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) fornito dal sistema.

Il callback PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) non blocca, non accoda una richiesta di allocazione e restituisce immediatamente.

Un driver usa il callback PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) insieme a un ISR fornito dal driver. Se il driver non dispone di una porta parallela allocata quando viene chiamato l'ISR del driver, il driver può usare questo callback.

Per altre informazioni sull'allocazione di una porta parallela in un ISR, vedere Connessione di una routine del servizio interrupt a unParallelPort.

Nota Il callback di PPARALLEL_TRY_ALLOCATE_ROUTINE (ISR) non è testato. Microsoft non consiglia l'uso di una routine di interrupt fornita dal client. L'uso di interrupt può causare instabilità del sistema. Per impostazione predefinita, la richiesta di IOCTL_INTERNAL_PARALLEL_CONNECT_INTERRUPT è disabilitata.