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. 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 |