次の方法で共有

AcxTargetElementFormatRequestForProperty 関数 (acxtargets.h)

  • [アーティクル]

AcxTargetElementFormatRequestForProperty 関数は、指定した要素ターゲットで使用する ACX プロパティ要求として WDFREQUEST を書式設定します。

構文

NTSTATUS AcxTargetElementFormatRequestForProperty(
  ACXTARGETELEMENT        TargetElement,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

パラメーター

TargetElement

ACXTARGETELEMENT ハンドル。 ACX オブジェクトの詳細については、ACX オブジェクトの概要を参照してください。

Request

フレームワーク オブジェクト の概要で説明されている WDFREQUEST ハンドル。 WDF 要求の一般的な情報については、「フレームワーク要求オブジェクトの作成 を参照してください。

Params

プロパティ要求パラメーター情報の格納に使用される初期化された ACX_REQUEST_PARAMETERS 構造体。

戻り値

呼び出しが成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切なエラー コードが返されます。 詳細については、NTSTATUS 値 の使用に関するを参照してください。

備考

WDFREQUEST は、ドライバーによって作成された I/O 要求です。 フレームワーク ベースのドライバーは、フレームワーク要求オブジェクト メソッドを呼び出すことによって、各 I/O 要求を処理します。 詳細については、「フレームワーク要求オブジェクトの」を参照してください。

例


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETELEMENT            targetElement;

...

    status = AcxTargetElementFormatRequestForProperty(targetElement, req, &params);

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目

  • acxtargets.h ヘッダー を する