Metodo IWDFIoRequest::GetInputMemory (wudfddi.h)

Articolo
03/05/2024

[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 GetInputMemory recupera l'oggetto memory 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 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 input è 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 GetInputMemory per ottenere il 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 memoria. 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'originatore della richiesta ha fornito. Il driver può chiamare GetInputMemory per ottenere il buffer di input per una richiesta di scrittura o una richiesta di controllo di 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 dei dati in UMDF-Based driver.

Esempio

Per un esempio di codice su come usare il metodo GetInputMemory , vedere IWDFIoRequest::Complete.

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