Método IMiniportMidiStream::Read (portcls.h)
El Read método lee los datos de una secuencia MIDI entrante.
Sintaxis
NTSTATUS Read(
[in] PVOID BufferAddress,
[in] ULONG BufferLength,
[out] PULONG BytesRead
);
Parámetros
[in] BufferAddress
Especifica la dirección de un búfer asignado por el autor de la llamada. El método copia los datos MIDI entrantes del dispositivo en el búfer. El tamaño asignado de este búfer debe ser mayor o igual que BufferLength.
[in] BufferLength
Especifica la longitud en bytes del búfer al que apunta BufferAddress.
[out] BytesRead
Puntero de salida a una variable asignada por el autor de la llamada en la que el método escribe un recuento que especifica el número real de bytes leídos correctamente del dispositivo en el búfer.
Valor devuelto
Read devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de retorno.
| Código devuelto | Descripción |
|---|---|
|
Solicitud de dispositivo no válida (por ejemplo, llamando a Read en un flujo de salida MIDI).
|
Comentarios
El controlador de minipuerto llama a IPortMidi::Notify para notificar al controlador de puerto cuando los datos MIDI entrantes están disponibles desde el dispositivo de captura. El controlador de puerto llama a IMiniportMidi::Read para recuperar los datos. El controlador de puerto sigue llamando Read siempre que haya más datos disponibles.
El Read método devuelve STATUS_SUCCESS y un recuento de BytesRead de cero para indicar que no hay más datos de entrada MIDI disponibles actualmente en el dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluir Portcls.h) |
| IRQL | DISPATCH_LEVEL |