WdfIoTargetCreate-Funktion (wdfiotarget.h)
[Gilt für KMDF und UMDF]
Die WdfIoTargetCreate-Methode erstellt ein Remote-I/O-Ziel für ein angegebenes Gerät.
Syntax
NTSTATUS WdfIoTargetCreate(
[in] WDFDEVICE Device,
[in, optional] PWDF_OBJECT_ATTRIBUTES IoTargetAttributes,
[out] WDFIOTARGET *IoTarget
);
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
[in, optional] IoTargetAttributes
Ein Zeiger auf eine aufgerufene WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das I/O-Zielobjekt angibt. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[out] IoTarget
Ein Zeiger auf eine Position, die ein Handle an ein I/O-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 I/O-Zielobjekt zu erstellen. |
|
Das parentObject-Element der WDF_OBJECT_ATTRIBUTES-Struktur , die IoTargetAttributes angegeben hat, hat das angegebene Framework-Geräteobjekt oder ein Objekt, dessen Übergeordnete kette zu diesem Objekt führt, nicht angegeben. |
Eine Liste anderer Rückgabewerte, die WdfIoTargetCreate zurückgeben kann, finden Sie unter Framework-Objekterstellungsfehler.
Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Bemerkungen
Nachdem ein Treiber WdfIoTargetCreate aufgerufen hat, muss der Treiber WdfIoTargetOpen aufrufen, bevor er Anforderungen an das Remote-I/O-Ziel senden kann.
Wenn der Treiber ein übergeordnetes Objekt im parentObject-Element der WDF_OBJECT_ATTRIBUTES Struktur angibt, kann es sich bei dem übergeordneten Objekt um ein Framework-Geräteobjekt oder ein beliebiges Objekt handeln, dessen Übergeordnete Kette zu einem Frameworkgerätobjekt führt. Das Framework löscht das I/O-Zielobjekt, wenn es (oder der Treiber) das Geräteobjekt löscht.
Weitere Informationen zu WdfIoTargetCreate finden Sie unter Initialisieren eines allgemeinen I/O-Ziels.
Wenn Ihr Treiber EvtCleanupCallback - oder EvtDestroyCallback-Rückruffunktionen für das I/O-Zielobjekt bereitstellt, beachten Sie, dass das Framework diese Rückruffunktionen bei IRQL = PASSIVE_LEVEL aufruft.
Weitere Informationen zu I/O-Zielen finden Sie unter Verwenden von I/O-Zielen.
Beispiele
Ein Codebeispiel, das WdfIoTargetCreate verwendet, finden Sie unter WdfIoTargetOpen.
Anforderungen
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Header | 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) |