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 最低版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

要求	價值
標頭	acxpin.h
IRQL	PASSIVE_LEVEL