AcxTargetPinFormatRequestForProperty function (acxtargets.h)

The AcxTargetPinFormatRequestForProperty formats a WDFREQUEST as an ACX property request to be used on specified pin target.

Syntax

NTSTATUS AcxTargetPinFormatRequestForProperty(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Parameters

TargetPin

An existing ACXTARGETPIN Object. For more information about ACX objects, see Summary of ACX Objects.

Request

A WDFREQUEST handle described in Summary of Framework Objects. For general information about WDF requests, see Creating Framework Request Objects.

Params

An initialized ACX_REQUEST_PARAMETERS structure that is used to store property request parameter information.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

A WDFREQUEST is a driver created I/O requests. Framework-based drivers process each I/O request by calling framework request object methods. For more information, see Framework Request Objects.

Example


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETPIN                targetPin;

...

    status = AcxTargetPinFormatRequestForProperty(targetPin, req, &params);

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement Value
Header acxtargets.h
IRQL PASSIVE_LEVEL

See also