EVT_ACX_PIN_RETRIEVE_NAME Rückruffunktion (acxpin.h)

Die EVT_ACX_PIN_RETRIEVE_NAME Rückruffunktion wird vom Treiber implementiert und aufgerufen, wenn der Name für den angegebenen Pin angefordert wird.

Syntax

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

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

Parameter

Pin

Ein ACXPIN-Objekt , das den spezifischen Pin darstellt, für den der Name angefordert wird.

Name

Ein Zeiger auf eine Unicode-Zeichenfolge, die mit dem angeforderten Pinnamen aufgefüllt werden soll.

Rückgabewert

EVT_ACX_PIN_RETRIEVE_NAME gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.

Hinweise

ACX weist den UNICODE_STRING Puffer vorab zu, bevor dieser Rückruf aufgerufen wird. Die maximale Anzahl von Wchars für den Namen ist MAX_PATH ohne NULL-Abschlussator. Der Treiber ist für das Kopieren des Namens in den Puffer und für das Aktualisieren des Unicode-Strukturlängenfelds auf die Anzahl von Bytes verantwortlich, die von der Namenszeichenfolge verwendet werden, ohne dass der NULL-Abschlussator enthalten ist.

ACX-Anforderungen

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung	Wert
Header	acxpin.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

• [acxpin.h-Header] (index.md)