Condividi tramite

Funzione AcxTargetElementFormatRequestForMethod (acxtargets.h)

  • Articolo

La funzione AcxTargetElementFormatRequestForMethod formatta una funzione WDFREQUEST come richiesta di metodo ACX da usare nella destinazione dell'elemento specificato.

Sintassi

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

Parametri

TargetElement

Handle ACXTARGETELEMENT. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

Request

Handle WDFREQUEST descritto in Riepilogo degli oggetti Framework. Per informazioni generali sulle richieste WDF, vedere Creazione di oggetti richiesta framework.

Params

Struttura di ACX_REQUEST_PARAMETERS inizializzata usata per archiviare le informazioni sui parametri della richiesta del metodo.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Un WDFREQUEST è un driver creato richieste di I/O. I driver basati su framework elaborano ogni richiesta di I/O chiamando i metodi dell'oggetto della richiesta framework. Per altre informazioni, vedere Oggetti richiesta framework.

Esempio

Questo codice di esempio mostra l'uso di 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);

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxtargets.h
IRQL PASSIVE_LEVEL

Vedi anche