IWDFIoRequest::GetInputMemory-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 GetInputMemory-Methode ruft das Speicherobjekt ab, das den Eingabepuffer in einer E/A-Anforderung darstellt.
Syntax
void GetInputMemory(
[out] IWDFMemory **ppWdfMemory
);
Parameter
[out] ppWdfMemory
Ein Zeiger auf eine Variable, die einen Zeiger auf die IWDFMemory-Schnittstelle mit Verweisanzahl für das Speicherobjekt empfängt. Beachten Sie, dass die Rückgabe von NULL gültig ist. in diesem Fall wird der E/A-Anforderung kein Eingabespeicher zugeordnet.
Rückgabewert
Keine
Bemerkungen
Treiber, die die gepufferte E/A-Zugriffsmethode verwenden, können GetInputMemory aufrufen, um den Eingabepuffer einer E/A-Anforderung abzurufen.
Bevor ein Treiber eine E/A-Anforderung abschließt, muss der Treiber die IWDFMemory::Release-Methode für das Speicherobjekt aufrufen. Das zugrunde liegende Speicherobjekt wird freigegeben, wenn die Anforderung abgeschlossen ist.
Der Eingabepuffer, der der E/A-Anforderung zugeordnet ist, enthält Informationen (z. B. Daten, die auf einen Datenträger geschrieben werden sollen), die der Absender der Anforderung bereitgestellt hat. Der Treiber kann GetInputMemory aufrufen, um den Eingabepuffer für eine Schreibanforderung oder eine Geräte-E/A-Steuerungsanforderung abzurufen, aber nicht für eine Leseanforderung (da Leseanforderungen keine Eingabedaten bereitstellen). Für den Zugriff auf den Eingabepuffer muss der Treiber die IWDFMemory::GetDataBuffer-Methode aufrufen.
UMDF erstellt die Speicherobjekte einer E/A-Anforderung, wenn die E/A-Anforderung empfangen wird, bevor die E/A-Anforderung der E/A-Warteschlange eines Treibers hinzugefügt wird. Wenn UMDF keinen Arbeitsspeicher für die Speicherobjekte zuweisen kann, schließt es die E/A-Anforderung mit einer Fehlerrückgabe status ab und übermittelt die E/A-Anforderung nicht an den Treiber.
Weitere Informationen zum Zugreifen auf die Datenpuffer einer E/A-Anforderung finden Sie unter Zugreifen auf Datenpuffer in UMDF-Based Treibern.
Beispiele
Ein Codebeispiel für die Verwendung der GetInputMemory-Methode finden Sie unter IWDFIoRequest::Complete.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |