Metodo IWDFIoRequest::GetWriteParameters (wudfddi.h)
Avvertimento
UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione a UMDF.
Il metodo GetWriteParameters recupera i parametri della richiesta per una richiesta di tipo scrittura.
Sintassi
void GetWriteParameters(
[out, optional] SIZE_T *pSizeInBytes,
[out, optional] LONGLONG *pullOffset,
[out, optional] ULONG *pulKey
);
Parametri
[out, optional] pSizeInBytes
Puntatore a una variabile che riceve le dimensioni, in byte, da scrivere. Per recuperare i dati per la scrittura, il driver chiama il metodo IWDFIoRequest::GetInputMemory.
Questo parametro è facoltativo. Il driver può passare NULL se non richiede le informazioni.
[out, optional] pullOffset
Puntatore a una variabile che riceve l'offset, in byte, per iniziare a scrivere nel dispositivo o nel file nel dispositivo. Se il dispositivo non supporta indirizzi di scrittura assoluti, pullOffset può essere ignorato. Per altre informazioni, vedere la sezione Osservazioni seguente.
Le applicazioni client specificano questo valore nei Offset e OffsetHigh membri della struttura OVERLAPPED. Un puntatore a OVERLAPPED viene passato nella funzione WriteFile di Microsoft Win32 o writeFileEx .
Questo parametro è facoltativo. Il driver può passare NULL se non richiede le informazioni.
[out, optional] pulKey
Puntatore a una variabile che riceve una chiave che il driver può usare per ordinare la richiesta di I/O in modo che il driver determini.
Questo parametro è facoltativo. Il driver può passare NULL se non richiede le informazioni.
Valore restituito
Nessuno
Osservazioni
Una chiamata a GetWriteParameters ha esito negativo se il tipo di richiesta non è un tipo di scrittura.
Per i dispositivi che supportano l'indirizzamento (ad esempio, un dispositivo disco), il valore a cui punta il pullOffset parametro è in genere l'offset di byte nel dispositivo. Per i dispositivi che non supportano l'indirizzamento (ad esempio, una porta seriale), il driver può ignorare il valore in pullOffset.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |