Metodo IQueueCallbackDeviceIoControl::OnDeviceIoControl (wudfddi.h)

  • Articolo

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 OnDeviceIoControl viene chiamato per gestire una richiesta di controllo di I/O del dispositivo quando un'applicazione esegue un'operazione specifica in un dispositivo tramite la funzione Microsoft Win32 OnDeviceIoControl .

Sintassi

void OnDeviceIoControl(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ControlCode,
       SIZE_T        InputBufferSizeInBytes,
       SIZE_T        OutputBufferSizeInBytes
);

Parametri

[in] pWdfQueue

Puntatore all'interfaccia IWDFIoQueue per l'oggetto coda di I/O da cui arriva la richiesta.

[in] pWdfRequest

Puntatore all'interfaccia IWDFIoRequest che rappresenta l'oggetto richiesta del framework.

[in] ControlCode

Codice di controllo I/O definito dal driver o definito dal sistema (IOCTL) che identifica l'operazione specifica da eseguire e associata alla richiesta.

InputBufferSizeInBytes

Dimensioni, in byte, del buffer di input per la richiesta.

OutputBufferSizeInBytes

Dimensioni, in byte, del buffer di output per la richiesta.

Valore restituito

nessuno

Osservazioni

Un driver registra l'interfaccia IQueueCallbackDeviceIoControl quando il driver chiama il metodo IWDFDevice::CreateIoQueue per creare una coda di I/O o per configurare la coda di I/O predefinita.

Un driver può implementare un singolo metodo OnDeviceIoControl per tutte le code di I/O o per i metodi OnDeviceIoControl separati per ogni coda di I/O.

Il metodo OnDeviceIoControl riceve ogni tipo di richiesta di controllo di I/O del dispositivo da una coda. Il tipo di richiesta è identificato dal valore WdfRequestDeviceIoControl del tipo di enumerazione WDF_REQUEST_TYPE per la richiesta.

Per altre informazioni sui metodi del driver associati alle code e sulle chiamate del framework, vedere Funzioni di callback degli eventi di coda I/O. Il metodo OnDeviceIoControl deve elaborare ogni richiesta di controllo di I/O del dispositivo ricevuto. Per altre informazioni su come i driver UMDF elaborano le richieste di I/O, vedere Elaborazione delle richieste di I/O.

Il driver può chiamare i metodi IWDFIoRequest::GetDeviceIoControlParameters, IWDFIoRequest::GetInputMemory e IWDFIoRequest::GetOutputMemory per recuperare informazioni sulla richiesta e sui buffer di input e output.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione wudfddi.h (include Wudfddi.h)

Vedi anche