Método IMiniportMidiStream::Read (portcls.h)

Artículo
03/05/2024

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
STATUS_INVALID_DEVICE_REQUEST	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.