次の方法で共有

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 バッファーを事前に割り当てます。 名前の wchars の最大数は、NULL ターミネータを含まないMAX_PATH。 ドライバーは、バッファー内の名前をコピーし、[Unicode 構造体の 長さ] フィールドを、NULL ターミネータを含まない名前文字列で使用されるバイト数に更新する役割を担います。

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。

要件

要件 値
Header acxpin.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

  • [acxpin.h ヘッダー](index.md)