Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 GetOutputMemory Methode ruft das Speicherobjekt ab, das den Ausgabepuffer für eine E/A-Anforderung darstellt.
Syntax
void GetOutputMemory(
[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 Ausgabespeicher zugeordnet.
Rückgabewert
Nichts
Bemerkungen
Treiber, die die gepufferten E/A--Zugriffsmethode verwenden, können GetOutputMemory- aufrufen, um den Ausgabepuffer 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 Ausgabepuffer, der der E/A-Anforderung zugeordnet ist, enthält Informationen (z. B. Daten von einem Datenträger), die der Treiber dem Absender der Anforderung bereitstellt. Der Treiber kann GetOutputMemory- aufrufen, um den Ausgabepuffer für eine Leseanforderung oder eine Geräte-E/A-Steuerelementanforderung abzurufen, aber nicht für eine Schreibanforderung (da Schreibanforderungen keine Ausgabedaten bereitstellen). Um auf den Ausgabepuffer 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 GetOutputMemory--Methode finden Sie unter IWDFIoQueue::RetrieveNextRequest.
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 |