IWDFIoRequest::GetOutputMemory-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 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 IWDFMemory-Schnittstelle mit Verweisanzahl für das Speicherobjekt empfängt. Beachten Sie, dass die Rückgabe von NULL gültig ist. in diesem Fall ist der E/A-Anforderung kein Ausgabespeicher zugeordnet.

Rückgabewert

Keine

Bemerkungen

Treiber, die die gepufferte E/A-Zugriffsmethode verwenden, können GetOutputMemory aufrufen, um den Ausgabepuffer 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 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 zur Verfügung stellt. Der Treiber kann GetOutputMemory aufrufen, um den Ausgabepuffer für eine Leseanforderung oder eine Geräte-E/A-Steuerungsanforderung abzurufen, aber nicht für eine Schreibanforderung (da Schreibanforderungen keine Ausgabedaten bereitstellen). Für den Zugriff auf den Ausgabepuffer 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 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
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFIoQueue::RetrieveNextRequest

IWDFIoRequest

IWDFMemory

IWDFMemory::GetDataBuffer