PNEGOTIATE_IEEE_MODE callback function (parallel.h)

  • Article

The PNEGOTIATE_IEEE_MODE-typed callback routine selects the fastest forward and reverse protocols that the system-supplied bus driver for parallel ports supports from among those specified by the caller. The system-supplied bus driver for parallel ports supplies this routine.

Syntax

PNEGOTIATE_IEEE_MODE PnegotiateIeeeMode;

NTSTATUS PnegotiateIeeeMode(
  [in] PVOID Extension,
  [in] UCHAR Extensibility
)
{...}

Parameters

[in] Extension

[in] Extensibility

Return value

Return code Description
STATUS_SUCCESSFUL The IEEE mode was successfully negotiated.
STATUS_DEVICE_PROTOCOL_ERROR An IEEE mode is already set on the device.
STATUS_Xxx An internal operation resulted in an NTSTATUS error.

Remarks

To obtain a pointer to the system-supplied PNEGOTIATE_IEEE_MODE callback, a kernel-mode driver uses an IOCTL_INTERNAL_PARCLASS_CONNECT request, which returns a PARCLASS_INFORMATION structure. The NegotiateIeeeMode member of the PARCLASS_INFORMATION structure is a pointer to this callback.

The PNEGOTIATE_IEEE_MODE callback runs in the caller's thread at the IRQL of the caller.

Requirements

Requirement Value
Target Platform Desktop
Header parallel.h (include Parallel.h)

See also