Share via

Fungsi AcxTargetElementFormatRequestForMethod (acxtargets.h)

  • Artikel

Fungsi AcxTargetElementFormatRequestForMethod memformat WDFREQUEST sebagai permintaan metode ACX yang akan digunakan pada target elemen tertentu.

Sintaks

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

Parameter

TargetElement

Handel ACXTARGETELEMENT. 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, kode kesalahan akan menampilkan 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

Kode sampel ini menunjukkan penggunaan AcxTargetElementFormatRequestForMethod.


    {
        ACXTARGETELEMENT targetElement          = NULL;
        ULONG            targetElementId        = 0;
        ULONG            targetElementsCount    = AcxTargetCircuitGetElementsCount(TargetCircuit);
        arg     = elementArg;
        result  = 0;

        targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);       

        ACX_REQUEST_PARAMETERS_INIT_METHOD(
            &params,
            KSMETHODSETID_AcxTestMethod,
            KSMETHOD_ACXELEMENT_TEST_IN2OUT,
            AcxMethodVerbSend,
            AcxItemTypeElement,
            targetElementId,
            &arg, sizeof(arg),      // Value & size
            &result, sizeof(result) // Control & size
            );  

        //
        // Format a WDF request as an ACX method request for the ACX element target.
        //
        status = AcxTargetElementFormatRequestForMethod(targetElement, 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