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 informazioni, vedi Introduzione a UMDF.]
Il metodo GetOutputMemory recupera l'oggetto memoria 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 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 output è associata alla richiesta di I/O.
Valore restituito
Nessuno
Osservazioni
I driver che usano il metodo di di I/O memorizzati nel buffer 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 memory. L'oggetto memoria sottostante viene liberato al termine della richiesta.
Il buffer di output associato alla richiesta di I/O contiene informazioni (ad esempio 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 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 di dati in driver UMDF-Based.
Esempi
Per un esempio di codice su come usare il metodo GetOutputMemory, vedere IWDFIoQueue::RetrieveNextRequest.
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 |