EVT_ACX_PIN_RETRIEVE_NAME 콜백 함수(acxpin.h)

아티클
02/22/2024

EVT_ACX_PIN_RETRIEVE_NAME 콜백 함수는 드라이버에 의해 구현되며 지정된 핀에 대한 이름을 요청할 때 호출됩니다.

구문

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

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

매개 변수

Pin

이름이 요청되는 특정 핀을 나타내는 ACXPIN 개체입니다.

Name

요청된 핀 이름으로 채울 유니코드 문자열에 대한 포인터입니다.

반환 값

EVT_ACX_PIN_RETRIEVE_NAME 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 NTSTATUS 오류 코드를 반환합니다.

설명

ACX는 이 콜백을 호출하기 전에 UNICODE_STRING 버퍼를 미리 할당합니다. 이름에 대한 최대 wchar 수는 MAX_PATH NULL 종결자를 포함하지 않습니다. 드라이버는 버퍼의 이름을 복사하고 유니코드 구조체 길이 필드를 NULL 종결자를 포함하지 않고 이름 문자열에서 사용하는 바이트 수로 업데이트해야 합니다.

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항	값
헤더	acxpin.h
IRQL	PASSIVE_LEVEL

추가 정보

[acxpin.h 헤더] (index.md)

다음을 통해 공유