(parallel.h) PPARALLEL_SET_CHIP_MODE 回呼函式

發行項
03/05/2024

PPARALLEL_SET_CHIP_MODE型別回呼例程會設定平行埠的作業模式。平行埠的系統提供的函式驅動程式會提供此例程。

語法

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

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

參數

[in] SetChipContext

平行埠功能裝置對象的裝置擴充指標， (FDO) 。

[in] ChipMode

指定平行埠的作業模式。 (如需作業模式的詳細資訊，請參閱 Microsoft Windows 驅動程式套件 [WDK].) 隨附於 parallel.h 檔案中，針對增強功能所定義的模式， (ECR)

傳回值

傳回碼	Description
STATUS_SUCCESS	已設定指定的作業模式。
STATUS_INVALID_DEVICE_STATE	未清除模式。
STATUS_NO_SUCH_DEVICE	指定的作業模式無效。

備註

若要取得系統提供PPARALLEL_SET_CHIP_MODE回呼的指標，內核模式驅動程式會使用傳回PARALLEL_PNP_INFORMATION結構的IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO要求。 PARALLEL_PNP_INFORMATION 結構的 TrySetChipMode 成員是這個回呼的指標。

呼叫端會搭配PPARALLEL_CLEAR_CHIP_MODE回呼使用PPARALLEL_SET_CHIP_MODE回呼。

若要設定新的模式，呼叫端必須先清除目前的模式。

如需詳細資訊，請參閱在 ParallelPort 上設定和清除通訊模式。