Condividi tramite

Funzione AcxTargetPinFormatRequestForMethod (acxtargets.h)

  • Articolo

La funzione della 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 Creazione di oggetti richiesta framework.

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 dei valori NTSTATUS.

Commenti

WDFREQUEST è un driver che crea richieste di I/O. I driver basati su framework elaborano ogni richiesta di I/O chiamando i metodi oggetto richiesta framework. Per altre informazioni, vedere Oggetti richiesta framework.

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 di ACX

Versione minima di ACX: 1.0

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

Requisiti

Requisito Valore
Intestazione acxtargets.h
IRQL PASSIVE_LEVEL

Vedi anche