IWDFIoRequest::GetReadParameters-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 GetReadParameters-Methode ruft die Anforderungsparameter für eine Lesetypanforderung ab.
Syntax
void GetReadParameters(
[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 lesende Größe in Bytes empfängt. Um die Daten zum Lesen abzurufen, ruft der Treiber die IWDFIoRequest::GetOutputMemory-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 Lesen vom Gerät oder der Datei auf dem Gerät zu beginnen. Wenn das Gerät keine absoluten Leseadressen 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 ReadFile oder ReadFileEx ü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 GetReadParameters schlägt fehl, wenn der Anforderungstyp kein Lesetyp 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.
Obwohl der Treiber optional NULL für jeden der Parameter pSizeInBytes, pullOffset und pulKey angeben kann, muss der Treiber mindestens einen Parameter ohne NULL angeben, damit GetReadParameters erfolgreich ausgeführt werden kann.
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 |