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 |
---|---|
|
È stato rilevato un parametro non valido. |
|
Memoria insufficiente per creare un nuovo oggetto di destinazione di I/O. |
|
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) |