Funzione WdfIoTargetCreate (wdfiotarget.h)

Articolo
03/22/2025

[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

Condividi tramite