WdfUsbTargetDeviceGetIoTarget-Funktion (wdfusb.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfUsbTargetDeviceGetIoTarget-Methode gibt ein Handle an das E/A-Zielobjekt zurück, das einem angegebenen USB-Gerät zugeordnet ist.

Syntax

WDFIOTARGET WdfUsbTargetDeviceGetIoTarget(
  [in] WDFUSBDEVICE UsbDevice
);

Parameter

[in] UsbDevice

Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.

Rückgabewert

Die WdfUsbTargetDeviceGetIoTarget-Methode gibt ein Handle an ein E/A-Zielobjekt zurück.

Eine Fehlerüberprüfung tritt auf, wenn ein vom Treiber bereitgestelltes Objekthandle ungültig ist.

Hinweise

Weitere Informationen zur WdfUsbTargetDeviceGetIoTarget-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Im folgenden Codebeispiel wird ein Anforderungsobjekt erstellt und überprüft, ob das Framework eine Anforderung an das E/A-Zielobjekt senden kann, das einem angegebenen USB-Gerät zugeordnet ist.

status = WdfRequestCreate(
                          &attributes,
                          WdfUsbTargetDeviceGetIoTarget(deviceContext->UsbTargetDevice),
                          &request
                          );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfusb.h (wdfusb.h einschließen)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

WdfUsbTargetDeviceCreateWithParameters

WdfUsbTargetPipeGetIoTarget