Condividi tramite


Funzione WdfIoTargetCreate (wdfiotarget.h)

[Si applica a KMDF e UMDF]

Il metodo WdfIoTargetCreate crea un di destinazione I/O remoto per un dispositivo specificato.

Sintassi

NTSTATUS WdfIoTargetCreate(
  [in]           WDFDEVICE              Device,
  [in, optional] PWDF_OBJECT_ATTRIBUTES IoTargetAttributes,
  [out]          WDFIOTARGET            *IoTarget
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in, optional] IoTargetAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che specifica gli attributi dell'oggetto per l'oggetto di destinazione di I/O. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[out] IoTarget

Puntatore a una posizione che riceve un handle per un oggetto di destinazione di I/O.

Valore restituito

WdfIoTargetCreate restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER
È stato rilevato un parametro non valido.
STATUS_INSUFFICIENT_RESOURCES
Memoria insufficiente per creare un nuovo oggetto di destinazione di I/O.
STATUS_INVALID_DEVICE_REQUEST
Il membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES che IoTargetAttributes specificato non ha specificato l'oggetto dispositivo framework che Device specificato o un oggetto la cui catena di elementi padre conduce a tale oggetto.
 

Per un elenco di altri valori restituiti che possono essere restituiti da WdfIoTargetCreate, vedere Framework Object Creation Errors.

Questo metodo potrebbe anche restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni:

Dopo che un driver chiama WdfIoTargetCreate, il driver deve chiamare WdfIoTargetOpen prima di poter inviare richieste alla destinazione di I/O remota.

Se il driver specifica un oggetto padre nella struttura WDF_OBJECT_ATTRIBUTESmembro ParentObject, l'oggetto padre può essere un oggetto dispositivo framework o qualsiasi oggetto la cui catena di elementi padre conduce a un oggetto dispositivo framework. Il framework eliminerà l'oggetto di destinazione di I/O quando (o il driver) eliminerà l'oggetto dispositivo.

Per altre informazioni su WdfIoTargetCreate, vedere Inizializzazione di una destinazione di I/O generale.

Se il driver fornisce EvtCleanupCallback o EvtDestroyCallback funzioni di callback per l'oggetto di destinazione I/O, si noti che il framework chiama queste funzioni di callback in IRQL = PASSIVE_LEVEL.

Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.

Esempi

Per un esempio di codice che usa WdfIoTargetCreate, vedere WdfIoTargetOpen.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
versione minima di KMDF 1.0
versione minima di UMDF 2.0
intestazione wdfiotarget.h (include Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_OBJECT_ATTRIBUTES

WdfIoTargetOpen