IWDFDevice2::GetDeviceStackIoTypePreference-Methode (wudfddi.h)

  • Artikel

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die GetDeviceStackIoTypePreference-Methode ruft die Pufferzugriffsmethoden ab, die das Framework für ein Gerät verwendet.

Syntax

void GetDeviceStackIoTypePreference(
  [out] WDF_DEVICE_IO_TYPE *ReadWritePreference,
  [out] WDF_DEVICE_IO_TYPE *IoControlPreference
);

Parameter

[out] ReadWritePreference

Ein Zeiger auf einen vom Treiber zugewiesenen Speicherort, der einen WDF_DEVICE_IO_TYPE typisierten Wert empfängt. Dieser Wert identifiziert die Pufferzugriffsmethode, die das Framework für lese- und schreibanforderungen eines Geräts verwendet.

[out] IoControlPreference

Ein Zeiger auf einen vom Treiber zugewiesenen Speicherort, der einen WDF_DEVICE_IO_TYPE typisierten Wert empfängt. Dieser Wert, der die Pufferzugriffsmethode identifiziert, die das Framework für die E/A-Steuerungsanforderungen eines Geräts verwendet.

Rückgabewert

Keine

Bemerkungen

Wenn Ihr Treiber GetDeviceStackIoTypePreference aufruft, bevor der PnP-Manager alle Treiber des Geräts geladen hat, sind die Werte, die GetDeviceStackIoTypePreference abruft, möglicherweise nicht die Werte, die er tatsächlich verwendet.

Weitere Informationen dazu, wie das Framework eine Pufferzugriffsmethode auswäht, finden Sie unter So wählt UMDF eine Pufferzugriffsmethode für eine E/A-Anforderung aus.

Beispiele

Im folgenden Codebeispiel werden die Pufferzugriffsmethoden abgerufen, die das Framework für ein Gerät verwendet.

WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;

Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
                                        &IoControlAccessMethod);

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform Desktop
UMDF-Mindestversion 1.9
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen

IWDFDevice2

IWDFDeviceInitialize2::SetIoTypePreference