PPARALLEL_CLEAR_CHIP_MODE funzione di callback (parallel.h)

Articolo
02/29/2024

La routine di callback tipizzata PPARALLEL_CLEAR_CHIP_MODE cancella la modalità operativa di una porta parallela reimpostando la modalità di comunicazione del chipset host sulla modalità di compatibilità IEEE 1284. Il driver di funzione fornito dal sistema per le porte parallele fornisce questa routine.

Sintassi

PPARALLEL_CLEAR_CHIP_MODE PparallelClearChipMode;

NTSTATUS PparallelClearChipMode(
  [in] PVOID ClearChipContext,
  [in] UCHAR ChipMode
)
{...}

Parametri

[in] ClearChipContext

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

[in] ChipMode

Specifica la modalità operativa corrente della 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	La modalità operativa è stata impostata sulla modalità di compatibilità IEEE 1284.
STATUS_INVALID_DEVICE_STATE	La modalità specificata non corrisponde alla modalità corrente.

Commenti

Per ottenere un puntatore al callback PPARALLEL_CLEAR_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 ClearChipMode della struttura PARALLEL_PNP_INFORMATION è un puntatore a questo callback.

Un chiamante usa il callback PPARALLEL_CLEAR_CHIP_MODE insieme al callback PPARALLEL_SET_CHIP_MODE .

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

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