Metodo IWDFIoRequest::GetInputMemory (wudfddi.h)
[Avviso: 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, vedi Introduzione a UMDF.]
Il metodo GetInputMemory recupera l'oggetto memoria che rappresenta il buffer di input in una richiesta di I/O.
Sintassi
void GetInputMemory(
[out] IWDFMemory **ppWdfMemory
);
Parametri
[out] ppWdfMemory
Puntatore a una variabile che riceve un puntatore al IWDFMemory con conteggio dei riferimenti'interfaccia per l'oggetto memory. Si noti che la restituzione di NULL è valida; in questo caso, nessuna memoria di input è associata alla richiesta di I/O.
Valore restituito
Nessuno
Osservazioni
I driver che usano il metodo di I/O memorizzato nel buffer possono chiamare GetInputMemory per ottenere un buffer di input di una richiesta di I/O.
Prima che un driver completi una richiesta di I/O, il driver deve chiamare il metodo IWDFMemory::Release per l'oggetto memory. L'oggetto memoria sottostante viene liberato al termine della richiesta.
Il buffer di input associato alla richiesta di I/O contiene informazioni,ad esempio i dati da scrivere in un disco, che l'origine della richiesta fornita. Il driver può chiamare GetInputMemory per ottenere il buffer di input per una richiesta di scrittura o una richiesta di controllo I/O del dispositivo, ma non per una richiesta di lettura (perché le richieste di lettura non forniscono dati di input). Per accedere al buffer di input, il driver deve chiamare il metodo IWDFMemory::GetDataBuffer.
UMDF crea gli oggetti di memoria di una richiesta di I/O quando riceve la richiesta di I/O, prima di aggiungere la richiesta di I/O alla coda di I/O di un driver. Se UMDF non può allocare memoria per gli oggetti memoria, completa la richiesta di I/O con uno stato restituito di errore e non recapita la richiesta di I/O al driver.
Per altre informazioni sull'accesso ai buffer di dati di una richiesta di I/O, vedere Accesso ai buffer di dati in driver UMDF-Based.
Esempi
Per un esempio di codice su come usare il metodo GetInputMemory, vedere IWDFIoRequest::Complete.
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 |