Metodo IWDFIoRequest::GetOutputMemory (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 info, vedi Introduzione con UMDF.]
Il metodo GetOutputMemory recupera l'oggetto memory che rappresenta il buffer di output per una richiesta di I/O.
Sintassi
void GetOutputMemory(
[out] IWDFMemory **ppWdfMemory
);
Parametri
[out] ppWdfMemory
Puntatore a una variabile che riceve un puntatore all'interfaccia IWDFMemory con conteggio dei riferimenti per l'oggetto memoria. Si noti che la restituzione di NULL è valida; in questo caso, nessuna memoria di output è associata alla richiesta di I/O.
Valore restituito
nessuno
Osservazioni
I driver che usano il metodo di accesso I/O memorizzato nel buffer possono chiamare GetOutputMemory per ottenere il buffer di output 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 memoria. L'oggetto memoria sottostante viene liberato al termine della richiesta.
Il buffer di output associato alla richiesta di I/O contiene informazioni, ad esempio i dati di un disco, forniti dal driver all'origine della richiesta. Il driver può chiamare GetOutputMemory per ottenere il buffer di output per una richiesta di lettura o una richiesta di controllo di I/O del dispositivo, ma non per una richiesta di scrittura (perché le richieste di scrittura non forniscono dati di output). Per accedere al buffer di output, 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 dei dati in UMDF-Based driver.
Esempio
Per un esempio di codice su come usare il metodo GetOutputMemory , vedere IWDFIoQueue::RetrieveNextRequest.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |