IWDFDevice2::GetDeviceStackIoTypePreference-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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-typed-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-typed-Wert empfängt. Dieser Wert, der die Pufferzugriffsmethode identifiziert, die das Framework für die E/A-Anforderungen eines Geräts verwendet.
Rückgabewert
Nichts
Bemerkungen
Wenn Ihr Treiber GetDeviceStackIoTypePreference aufruft, bevor der PnP-Manager alle Gerätetreiber geladen hat, sind die Werte, die GetDeviceStackIoTypePreference abgerufen werden, möglicherweise nicht die Werte, die sie tatsächlich verwendet.
Weitere Informationen dazu, wie das Framework eine Pufferzugriffsmethode auswäht, finden Sie unter How UMDF Chooses a Buffer Access Method for an I/O Request.
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 |
| Mindest-UMDF-Version | 1.9 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |