Metodo IWDFIoRequest::GetDeviceIoControlParameters (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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Il metodo GetDeviceIoControlParameters recupera i parametri della richiesta per una richiesta di tipo di controllo I/O del dispositivo.

Sintassi

void GetDeviceIoControlParameters(
  [out] ULONG  *pControlCode,
  [out] SIZE_T *pInBufferSize,
  [out] SIZE_T *pOutBufferSize
);

Parametri

[out] pControlCode

Puntatore a una variabile che riceve il codice di controllo che identifica l'operazione specifica da eseguire.

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

[out] pInBufferSize

Puntatore a una variabile che riceve le dimensioni, in byte, del buffer di dati di input per la richiesta. Per recuperare il buffer dei dati di input, il driver chiama il metodo IWDFIoRequest::GetInputMemory .

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

[out] pOutBufferSize

Puntatore a una variabile che riceve le dimensioni, in byte, del buffer di dati di output per la richiesta. Per recuperare il buffer dei dati di output, il driver chiama il metodo IWDFIoRequest::GetOutputMemory .

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

Valore restituito

nessuno

Osservazioni

La chiamata a GetDeviceIoControlParameters ha esito negativo se il tipo di richiesta non è un tipo di controllo I/O del dispositivo.

Sebbene il driver possa facoltativamente specificare NULL per ognuno dei parametri pControlCode, pInBufferSize e pOutBufferSize, il driver deve specificare almeno un parametro non NULL per GetDeviceIoControlParameters per l'esecuzione corretta.

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

Vedi anche

IWDFIoRequest

IWDFIoRequest::GetInputMemory

IWDFIoRequest::GetOutputMemory