PPARALLEL_SET_CHIP_MODE funzione di callback (parallel.h)

Articolo
02/29/2024

La routine di callback tipizzata PPARALLEL_SET_CHIP_MODE imposta la modalità operativa di una porta parallela. Il driver di funzione fornito dal sistema per le porte parallele fornisce questa routine.

Sintassi

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

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

Parametri

[in] SetChipContext

Puntatore all'estensione del dispositivo dell'oggetto dispositivo funzionale di una porta parallela.

[in] ChipMode

Specifica la modalità operativa di una porta parallela. Per altre informazioni sulle modalità operative, vedere le modalità definite per il registro delle funzionalità avanzate (ECR) nel file parallel.h incluso in Microsoft Windows Driver Kit [WDK].)

Valore restituito

Codice restituito	Descrizione
STATUS_SUCCESS	È stata impostata la modalità operativa specificata.
STATUS_INVALID_DEVICE_STATE	La modalità non è deselezionata.
STATUS_NO_SUCH_DEVICE	La modalità operativa specificata non è valida.

Commenti

Per ottenere un puntatore al callback PPARALLEL_SET_CHIP_MODE fornito dal sistema, un driver in modalità kernel usa una richiesta di IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO , che restituisce una struttura PARALLEL_PNP_INFORMATION . Il membro TrySetChipMode della struttura PARALLEL_PNP_INFORMATION è un puntatore a questo callback.

Un chiamante usa il callback PPARALLEL_SET_CHIP_MODE insieme al callback PPARALLEL_CLEAR_CHIP_MODE .

Per impostare una nuova modalità, un chiamante deve prima cancellare la modalità corrente.

Per altre informazioni, vedere Impostazione e cancellazione della modalità di comunicazione in un parallelPort.