Share via

Fungsi AcxTargetPinFormatRequestForMethod (acxtargets.h)

  • Artikel

Fungsi fungsi AcxTargetPinFormatRequestForMethod memformat WDFREQUEST sebagai permintaan metode ACX yang akan digunakan pada target pin yang ditentukan.

Sintaks

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

Parameter

TargetPin

Objek ACXTARGETPIN yang ada. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.

Request

Handel WDFREQUEST yang dijelaskan dalam Ringkasan Objek Kerangka Kerja. Untuk informasi umum tentang permintaan WDF, lihat Membuat Objek Permintaan Kerangka Kerja.

Params

Struktur ACX_REQUEST_PARAMETERS yang diinisialisasi yang digunakan untuk menyimpan informasi parameter permintaan metode.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, ia mengembalikan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Keterangan

WDFREQUEST adalah driver yang membuat permintaan I/O. Driver berbasis kerangka kerja memproses setiap permintaan I/O dengan memanggil metode objek permintaan kerangka kerja. Untuk informasi selengkapnya, lihat Objek Permintaan Kerangka Kerja.

Contoh

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, req, &params);

Persyaratan ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan Nilai
Header acxtargets.h
IRQL PASSIVE_LEVEL

Lihat juga