E/S de canalización sincrónica y superpuesta

Las ReadFile, WriteFile, TransactNamedPipey ConnectNamedPipe funciones pueden realizar operaciones de entrada y salida en una canalización de forma sincrónica o asincrónica. Cuando una función se ejecuta de forma sincrónica, no devuelve hasta que se completa la operación que realiza. Esto significa que la ejecución del subproceso que realiza la llamada se puede bloquear durante un período indefinido mientras espera a que se complete una operación que consume mucho tiempo. Cuando una función se ejecuta de forma asincrónica, devuelve inmediatamente, incluso si no se ha completado la operación. Esto permite ejecutar una operación que consume mucho tiempo en segundo plano mientras el subproceso que realiza la llamada es libre para realizar otras tareas.

El uso de E/S asincrónica permite que un servidor de canalización use un bucle que realice los pasos siguientes:

1. Especifique varios objetos de evento en una llamada a la función wait y espere a que uno de los objetos se establezca en el estado señalado.
2. Use el valor devuelto de la función wait para determinar qué operación superpuesta ha finalizado.
3. Realice las tareas necesarias para limpiar la operación completada e inicie la siguiente operación para ese identificador de canalización. Esto puede implicar iniciar otra operación superpuesta para el mismo identificador de canalización.

Las operaciones superpuestas permiten que una canalización lea y escriba datos simultáneamente y para que un único subproceso realice operaciones simultáneas de E/S en varios identificadores de canalización. Esto permite que un servidor de canalización de un solo subproceso controle las comunicaciones con varios clientes de canalización de forma eficaz. Para obtener un ejemplo, vea servidor de canalización con nombre mediantede E/S superpuestas.

Para que un servidor de canalización use operaciones sincrónicas para comunicarse con más de un cliente, debe crear un subproceso independiente para cada cliente de canalización para que uno o varios subprocesos se puedan ejecutar mientras otros subprocesos están esperando. Para obtener un ejemplo de un servidor de canalización multiproceso que usa operaciones sincrónicas, consulte servidor de canalización multiproceso.

Habilitación de la operación asincrónica

LasReadFile , WriteFile, TransactNamedPipey funciones de ConnectNamedPipe solo se pueden realizar de forma asincrónica si habilita el modo superpuesto para el identificador de canalización especificado y especifica un puntero válido a una estructuraSUPERPUESTA. Si el puntero SUPERPUESTO es NULL, el valor devuelto de la función puede indicar incorrectamente que se ha completado la operación. Por lo tanto, se recomienda encarecidamente que, si crea un identificador con FILE_FLAG_OVERLAPPED y desea un comportamiento asincrónico, siempre debe especificar una estructura SUPERPUESTA válida.

El miembro hEvent del SUPERPUESTO especificado debe contener un identificador para un objeto de evento de restablecimiento manual. Se trata de un objeto de sincronización creado por la función CreateEvent. El subproceso que inicia la operación superpuesta usa el objeto de evento para determinar cuándo ha finalizado la operación. No debe usar el identificador de canalización para la sincronización al realizar operaciones simultáneas en el mismo identificador porque no hay ninguna manera de saber qué finalización de la operación provocó que se señale el identificador de canalización. La única técnica confiable para realizar operaciones simultáneas en el mismo controlador de canalización es usar una estructura de superpuesta independiente con su propio objeto de evento para cada operación. Para obtener más información sobre los objetos de evento, vea Synchronization.

Además, puede recibir una notificación cuando se completa una operación superpuesta mediante las funciones GetQueuedCompletionStat us o GetQueuedCompletionStatusEx. En este caso, no es necesario asignar el evento de restablecimiento manual en la estructura de SUPERPUESTA y la finalización se produce en el controlador de canalización de la misma manera que una operación asincrónica de lectura o escritura. Para obtener más información, consulte puertos de finalización de E/S.

Cuando readFile, writeFile, TransactNamedPipey operaciones de ConnectNamedPipe se realizan de forma asincrónica, se produce una de las siguientes acciones:

• Si la operación se completa cuando se devuelve la función, el valor devuelto indica el éxito o error de la operación. Si se produce un error, el valor devuelto es cero y la función GetLastError devuelve algo distinto de ERROR_IO_PENDING.
• Si la operación no ha finalizado cuando la función devuelve, el valor devuelto es cero y GetLastError devuelve ERROR_IO_PENDING. En este caso, el subproceso que llama debe esperar hasta que finalice la operación. A continuación, el subproceso de llamada debe llamar a la funciónGetOverlappedResult para determinar los resultados.

Usar rutinas de finalización

Las funciones ReadFileEx y WriteFileEx proporcionan otra forma de E/S superpuesta. A diferencia de las funcionesReadFile y WriteFilesuperpuestas, que usan un objeto de evento para indicar la finalización, las funciones extendidas especifican una rutina de finalización . Una rutina de finalización es una función que se pone en cola para su ejecución cuando finaliza la operación de lectura o escritura. La rutina de finalización no se ejecuta hasta que el subproceso que llamó a readFileEx y WriteFileEx inicia una operación de espera de alertable llamando a una de las funciones de espera de alerta con el parámetro fAlertable establecido en TRUE. En una operación de espera alertable, las funciones también devuelven cuando una ReadFileEx o WriteFileEx rutina de finalización se pone en cola para su ejecución. Un servidor de canalización puede usar las funciones extendidas para realizar una secuencia de operaciones de lectura y escritura para cada cliente que se conecta a ella. Cada operación de lectura o escritura de la secuencia especifica una rutina de finalización y cada rutina de finalización inicia el siguiente paso en la secuencia. Para obtener un ejemplo, vea servidor de canalización con nombre mediante rutinas de finalización.