Funzione AcxTargetElementFormatRequestForProperty (acxtargets.h)

La funzione AcxTargetElementFormatRequestForProperty formatta una funzione WDFREQUEST come richiesta di proprietà ACX da usare nella destinazione dell'elemento specificata.

Sintassi

NTSTATUS AcxTargetElementFormatRequestForProperty(
  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 Creating Framework Request Objects.

Params

Struttura di ACX_REQUEST_PARAMETERS inizializzata utilizzata per archiviare le informazioni sui parametri della richiesta di proprietà.

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

    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETELEMENT            targetElement;

...

    status = AcxTargetElementFormatRequestForProperty(targetElement, 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