通过

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 版本概述。

要求

要求 值
Header acxpin.h
IRQL PASSIVE_LEVEL

另请参阅

  • [acxpin.h header] (index.md)