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
STATUS_INVALID_PARAMETER
Ein ungültiger Parameter wurde erkannt.
STATUS_INSUFFICIENT_RESOURCES
Es war nicht genügend Arbeitsspeicher vorhanden, um ein neues I/O-Zielobjekt zu erstellen.
STATUS_INVALID_DEVICE_REQUEST
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)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES

WdfIoTargetOpen