IWDFIoRequest::GetWriteParameters-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 für neuere 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 GetWriteParameters-Methode ruft die Anforderungsparameter für eine Schreibtypanforderung ab.
Syntax
void GetWriteParameters(
[out, optional] SIZE_T *pSizeInBytes,
[out, optional] LONGLONG *pullOffset,
[out, optional] ULONG *pulKey
);
Parameter
[out, optional] pSizeInBytes
Ein Zeiger auf eine Variable, die die zu schreibende Größe in Bytes empfängt. Um die Daten zum Schreiben abzurufen, ruft der Treiber die IWDFIoRequest::GetInputMemory-Methode auf.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.
[out, optional] pullOffset
Ein Zeiger auf eine Variable, die den Offset in Bytes empfängt, um mit dem Schreiben auf das Gerät oder die Datei auf dem Gerät zu beginnen. Wenn das Gerät keine absoluten Schreibadressen unterstützt, kann pullOffset ignoriert werden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Clientanwendungen geben diesen Wert im Offset - und OffsetHigh-Member der OVERLAPPED-Struktur an. Ein Zeiger auf OVERLAPPED wird in der Funktion "Microsoft Win32 WriteFile" oder "WriteFileEx " übergeben.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.
[out, optional] pulKey
Ein Zeiger auf eine Variable, die einen Schlüssel empfängt, den der Treiber verwenden kann, um die E/A-Anforderung auf eine weise zu sortieren, die der Treiber bestimmt.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn er die Informationen nicht benötigt.
Rückgabewert
Keine
Bemerkungen
Ein Aufruf von GetWriteParameters schlägt fehl, wenn der Anforderungstyp kein Schreibtyp ist.
Bei Geräten, die die Adressierung unterstützen (z. B. ein Datenträgergerät), ist der Wert, auf den der pullOffset-Parameter verweist, in der Regel der Byteoffset auf das Gerät. Bei Geräten, die keine Adressierung unterstützen (z. B. einen seriellen Port), kann der Treiber den Wert bei pullOffset ignorieren.
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 |