EVT_ACX_PIN_RETRIEVE_NAME回调函数 (acxpin.h)

EVT_ACX_PIN_RETRIEVE_NAME 回调函数由驱动程序实现,并在请求指定引脚的名称时调用。

语法

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

NTSTATUS EvtAcxPinRetrieveName(
  ACXPIN Pin,
  PUNICODE_STRING Name
)
{...}

参数

Pin

ACXPIN 对象,该对象表示为其请求名称的特定引脚。

Name

指向要用请求的引脚名称填充的 Unicode 字符串的指针。

返回值

如果调用成功,EVT_ACX_PIN_RETRIEVE_NAME 返回STATUS_SUCCESS。 否则,它将返回 NTSTATUS 错误代码。

言论

ACX 在调用此回调之前预分配UNICODE_STRING缓冲区。 名称的最大 wchar 数MAX_PATH不包括 NULL 终止符。 驱动程序负责将缓冲区中的名称复制,并将 Unicode 结构 Length 字段更新为名称字符串使用的字节数,不包括 NULL 终止符。

ACX 要求

最低 ACX 版本: 1.0

有关 ACX 版本的详细信息,请参阅 ACX 版本概述

要求

要求 价值
标头 acxpin.h
IRQL PASSIVE_LEVEL

另请参阅

  • [acxpin.h 标头](index.md)