Método IWDFIoRequest::GetDeviceIoControlParameters (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método GetDeviceIoControlParameters recupera os parâmetros de solicitação para uma solicitação de tipo de controle de E/S do dispositivo.
Sintaxe
void GetDeviceIoControlParameters(
[out] ULONG *pControlCode,
[out] SIZE_T *pInBufferSize,
[out] SIZE_T *pOutBufferSize
);
Parâmetros
[out] pControlCode
Um ponteiro para uma variável que recebe o código de controle que identifica a operação específica a ser executada.
Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.
[out] pInBufferSize
Um ponteiro para uma variável que recebe o tamanho, em bytes, do buffer de dados de entrada para a solicitação. Para recuperar o buffer de dados de entrada, o driver chama o método IWDFIoRequest::GetInputMemory .
Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.
[out] pOutBufferSize
Um ponteiro para uma variável que recebe o tamanho, em bytes, do buffer de dados de saída para a solicitação. Para recuperar o buffer de dados de saída, o driver chama o método IWDFIoRequest::GetOutputMemory .
Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.
Retornar valor
Nenhum
Comentários
A chamada para GetDeviceIoControlParameters falhará se o tipo de solicitação não for um tipo de controle de E/S do dispositivo.
Embora o driver possa, opcionalmente, especificar NULL para cada um dos parâmetros pControlCode, pInBufferSize e pOutBufferSize , o driver deve especificar pelo menos um parâmetro não NULL para GetDeviceIoControlParameters ser executado com êxito .
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1.5 |
| Cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| DLL | WUDFx.dll |