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. 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 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 referenzgezählte IWDFMemory- Schnittstelle für das Speicherobjekt empfängt. Beachten Sie, dass das Zurückgeben NULL- gültig ist; in diesem Fall ist der E/A-Anforderung kein Eingabespeicher zugeordnet.
Rückgabewert
Nichts
Bemerkungen
Treiber, die die gepufferten E/A--Zugriffsmethode verwenden, können GetInputMemory- aufrufen, um den Eingabepuffer einer E/A-Anforderung abzurufen.
Bevor ein Treiber eine E/A-Anforderung abgeschlossen hat, 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), den der Absender der bereitgestellten Anforderung angibt. Der Treiber kann GetInputMemory- aufrufen, um den Eingabepuffer für eine Schreibanforderung oder eine Geräte-E/A-Steuerelementanforderung abzurufen, aber nicht für eine Leseanforderung (da Leseanforderungen keine Eingabedaten bereitstellen). Um auf den Eingabepuffer zuzugreifen, muss der Treiber die IWDFMemory::GetDataBuffer-Methode aufrufen.
UMDF erstellt die Speicherobjekte einer E/A-Anforderung, wenn sie die E/A-Anforderung empfängt, bevor sie die E/A-Anforderung einer E/A-Warteschlange eines Treibers hinzufügt. Wenn UMDF den Arbeitsspeicher für die Speicherobjekte nicht zuordnen kann, schließt sie die E/A-Anforderung mit einem Fehlerrücklaufstatus ab und liefert 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 Drivers.
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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |