Enviando solicitações de E/S de forma síncrona
A tabela a seguir lista os métodos de objeto de destino de E/S que o driver pode chamar para enviar solicitações de E/S de forma síncrona para um destino de E/S. Para obter informações detalhadas sobre como usar esses métodos, consulte as páginas de referência dos métodos.
| Método | Finalidade |
|---|---|
Envia uma solicitação de leitura |
|
Envia uma solicitação de gravação |
|
Envia uma solicitação de controle de dispositivo |
|
Envia uma solicitação de controle de dispositivo interno |
|
Envia uma solicitação de controle de dispositivo interno não padrão |
Você também pode enviar solicitações de forma síncrona chamando WdfRequestSend, mas você precisa formatar a solicitação primeiro seguindo as regras descritas em Enviar solicitações de E/S de forma assíncrona.
Enviar solicitações de E/S para um destino de E/S de forma síncrona é mais simples de programar do que enviar solicitações de E/S de forma assíncrona. No entanto, você deve usar as seguintes diretrizes para ajudá-lo a decidir se a E/S síncrona é apropriada para o driver:
Você poderá usar E/S síncrona se o driver não enviar muitas solicitações de E/S e se o desempenho do sistema ou do dispositivo não for reduzido porque o driver aguarda a conclusão de cada solicitação de E/S.
Se o driver precisar lidar com muitas solicitações de E/S em curtos períodos de tempo, você provavelmente não poderá permitir que o driver aguarde a conclusão de cada solicitação antes de enviar a próxima solicitação. Caso contrário, o driver poderá perder dados ou reduzir o desempenho de seu dispositivo (e, possivelmente, de todo o sistema). Nesses casos, e/S assíncrona pode ser a melhor opção.
E/S síncrona é útil para lidar com operações que devem ser iniciadas e concluídas sem atividades simultâneas adicionais. Essas operações podem incluir a redefinição de um pipe USB ou a leitura de registros de dispositivo.
Na maioria das vezes, o driver deve especificar um valor de tempo limite quando chama um método de objeto que envia uma solicitação de E/S de forma síncrona. Se o driver não especificar um valor de tempo limite e se um dispositivo ou um driver de nível inferior não responder, o driver poderá parar. Como resultado, o usuário pode experimentar um aplicativo sem resposta. Além disso, outros drivers podem não conseguir obter recursos do sistema, como itens de trabalho, se o driver não os estiver liberando.
Se os drivers acima e abaixo do seu na pilha exigirem operações para continuar de forma síncrona, seu driver deverá usar E/S síncrona. Portanto, você deve aprender sobre os requisitos de outros drivers que podem existir na pilha de driver.
O exemplo a seguir mostra como enviar uma solicitação IOCTL (controle de E/S síncrona):
NTSTATUS status;
WDF_MEMORY_DESCRIPTOR inputDesc, outputDesc;
PWDF_MEMORY_DESCRIPTOR pInputDesc = NULL, pOutputDesc = NULL;
ULONG_PTR bytesReturned;
UNREFERENCED_PARAMETER(FileObject);
if (InputBuffer) {
WDF_MEMORY_DESCRIPTOR_INIT_BUFFER(&inputDesc,
InputBuffer,
InputBufferLength);
pInputDesc = &inputDesc;
}
if (OutputBuffer) {
WDF_MEMORY_DESCRIPTOR_INIT_BUFFER(&outputDesc,
OutputBuffer,
OutputBufferLength);
pOutputDesc = &outputDesc;
}
status = WdfIoTargetSendIoctlSynchronously(
IoTarget,
WDF_NO_HANDLE, // Request
IoctlControlCode,
pInputDesc,
pOutputDesc,
NULL, // PWDF_REQUEST_SEND_OPTIONS
&bytesReturned);
if (!NT_SUCCESS(status)) {
DEBUGP(MP_ERROR,
("WdfIoTargetSendIoctlSynchronously failed 0x%x\n",
status));
}
*BytesReadOrWritten = (ULONG)bytesReturned;