Funzione AcxTargetPinFormatRequestForMethod (acxtargets.h)

La funzione AcxTargetPinFormatRequestForMethod formatta una funzione WDFREQUEST come richiesta di metodo ACX da usare nella destinazione del pin specificata.

Sintassi

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

Parametri

TargetPin

Oggetto ACXTARGETPIN esistente. 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 Creating Framework Request Objects.

Params

Struttura di ACX_REQUEST_PARAMETERS inizializzata utilizzata 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 di valori NTSTATUS.

Osservazioni

WdFREQUEST è un driver che crea richieste di I/O. I driver basati sul framework elaborano ogni richiesta di I/O chiamando i metodi oggetto richiesta framework. Per altre informazioni, vedere Framework Request Objects.

Esempio

...
    _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);

Requisiti ACX

versione minima di ACX: 1.0

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

Fabbisogno

Requisito	Valore
intestazione	acxtargets.h
IRQL	PASSIVE_LEVEL

Vedere anche

• 'intestazione acxtargets.h