WdfIoTargetCreate-Funktion (wdfiotarget.h)
[Gilt für KMDF und UMDF]
Die WdfIoTargetCreate-Methode erstellt ein Remote-E/A-Ziel- für ein angegebenes Gerät.
Syntax
NTSTATUS WdfIoTargetCreate(
[in] WDFDEVICE Device,
[in, optional] PWDF_OBJECT_ATTRIBUTES IoTargetAttributes,
[out] WDFIOTARGET *IoTarget
);
Die Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
[in, optional] IoTargetAttributes
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das E/A-Zielobjekt angibt. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[out] IoTarget
Ein Zeiger auf eine Position, die ein Handle zu einem E/A-Zielobjekt empfängt.
Rückgabewert
WdfIoTargetCreate gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Ein ungültiger Parameter wurde erkannt. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um ein neues E/A-Zielobjekt zu erstellen. |
|
Das ParentObject Element der WDF_OBJECT_ATTRIBUTES-Struktur, die IoTargetAttributes angegeben, hat nicht das Framework-Geräteobjekt angegeben, das Device angegeben wurde, oder ein Objekt, dessen Übergeordnete Kette zu diesem Objekt führt. |
Eine Liste mit anderen Rückgabewerten, die WdfIoTargetCreate zurückgeben kann, finden Sie unter Framework Object Creation Errors.
Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Nachdem ein Treiber WdfIoTargetCreateaufgerufen hat, muss der Treiber WdfIoTargetOpen- aufrufen, bevor Er Anforderungen an das Remote-E/A-Ziel senden kann.
Wenn der Treiber ein übergeordnetes Objekt im WDF_OBJECT_ATTRIBUTES Element der ParentObject- Struktur angibt, kann es sich bei dem übergeordneten Objekt um ein Framework-Geräteobjekt oder um ein Objekt handeln, dessen Übergeordnete Kette zu einem Framework-Geräteobjekt führt. Das Framework löscht das E/A-Zielobjekt, wenn es (oder der Treiber) das Geräteobjekt löscht.
Weitere Informationen zu WdfIoTargetCreatefinden Sie unter Initialisieren eines allgemeinen E/A-Ziels.
Wenn Ihr Treiber EvtCleanupCallback oder EvtDestroyCallback- Rückruffunktionen für das E/A-Zielobjekt bereitstellt, beachten Sie, dass das Framework diese Rückruffunktionen bei IRQL = PASSIVE_LEVEL aufruft.
Weitere Informationen zu E/A-Zielen finden Sie unter Using I/O Targets.
Beispiele
Ein Codebeispiel, das WdfIoTargetCreateverwendet, finden Sie unter WdfIoTargetOpen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfiotarget.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |