acxTargetElementFormatRequestForProperty 函式 (acxtargets.h)

AcxTargetElementFormatRequestForProperty 函式會將 WDFREQUEST 格式化為要用於指定項目目標上的 ACX 屬性要求。

語法

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

參數

TargetElement

ACXTARGETELEMENT 句柄。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

Request

Framework 物件摘要中所述的 WDFREQUEST 句柄。 如需 WDF 要求的一般資訊，請參閱 建立架構要求物件。

Params

初始化 ACX_REQUEST_PARAMETERS 結構，用來儲存屬性要求參數資訊。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

WDFREQUEST 是驅動程式建立的 I/O 要求。 架構型驅動程式會呼叫架構要求物件方法來處理每個 I/O 要求。 如需詳細資訊，請參閱 Framework 要求物件。

範例

    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 標頭