WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE-Funktion (wdfiotarget.h)

[Gilt nur für KMDF]

Die WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE-Funktion initialisiert die WDF_IO_TARGET_OPEN_PARAMS Struktur eines Treibers, sodass der Treiber ein Remote-E/A-Ziel öffnen kann, indem ein Windows Driver Model (WDM)-Geräteobjekt angegeben wird.

Syntax

VOID WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in]  PDEVICE_OBJECT             DeviceObject
);

Die Parameter

[out] Params

Ein Zeiger auf eine vom Treiber zugewiesene WDF_IO_TARGET_OPEN_PARAMS Struktur, die die Funktion initialisiert.

[in] DeviceObject

Ein Zeiger auf eine DEVICE_OBJECT-Struktur, die als Wert für das DeviceObject Member der WDF_IO_TARGET_OPEN_PARAMS-Struktur verwendet wird.

Rückgabewert

Nichts

Bemerkungen

Die WDF_IO_TARGET_OPEN_PARAMS-Struktur wird als Eingabe für die WdfIoTargetOpen-Methode verwendet.

Die WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE-Funktion initialisiert die Elemente Size, Typeund TargetDeviceObject Member der angegebenen WDF_IO_TARGET_OPEN_PARAMS Struktur.

In der Regel legt ein Treiber das TargetFileObject Member der WDF_IO_TARGET_OPEN_PARAMS Struktur fest, nachdem der Treiber WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICEaufgerufen hat.

Weitere Informationen zu E/A-Zielen finden Sie unter Using I/O Targets.

Beispiele

Im folgenden Codebeispiel wird ein E/A-Zielobjekt erstellt und das Ziel geöffnet, indem eine DEVICE_OBJECT Struktur angegeben wird. Der Beispieltreiber ruft die DEVICE_OBJECT Struktur ab, indem NdisMGetDeviceProperty- aufgerufen wird (nicht angezeigt).

WDF_IO_TARGET_OPEN_PARAMS  openParams;
NTSTATUS  ntStatus;

ntStatus = WdfIoTargetCreate(
                             Adapter->WdfDevice,
                             WDF_NO_OBJECT_ATTRIBUTES,
                             &Adapter->IoTarget
                             );
if (!NT_SUCCESS(ntStatus)) {
    DEBUGP(MP_ERROR, ("WdfIoTargetCreate failed 0x%x\n", ntStatus));
    break;
}

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE(
                                               &openParams,
                                               Adapter->NextDeviceObject
                                               );

ntStatus = WdfIoTargetOpen(Adapter->IoTarget,
                           &openParams);
if (!NT_SUCCESS(ntStatus)) {
    DEBUGP(MP_ERROR, ("WdfIoTargetOpen failed 0x%x\n", ntStatus));
    break;
}

Anforderungen

Siehe auch

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME

WdfIoTargetOpen