次の方法で共有

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

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

要件 価値
ヘッダー acxpin.h
IRQL PASSIVE_LEVEL

関連項目

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