Funzione SerCxRetrieveTransmitMdl (sercx.h)

Il metodo SerCxRetrieveTransmitMdl recupera il MDL che descrive il buffer che contiene il blocco successivo di dati di output da trasmettere.

Sintassi

NTSTATUS SerCxRetrieveTransmitMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

Parametri

[in] Device

Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.

[out] Mdl

Puntatore a una posizione in cui il metodo scrive un puntatore nel file MDL.

Valore restituito

SerCxRetrieveTransmitMdl restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti possibili includono i codici di errore seguenti.

Codice restituito

Descrizione

STATUS_INVALID_DEVICE_REQUEST

Questo valore viene restituito se si verifica una delle condizioni seguenti: Non esiste alcuna richiesta di trasmissione in sospeso da cui ottenere un MDL. Il numero corrente di byte trasmessi (come segnalato dal metodo SerCxProgressTransmit) non è uguale a zero. Il buffer è già stato recuperato e la chiamata corrispondente al metodo SerCxProgressTransmit non è ancora stata eseguita. Il file MDL è già stato recuperato (e la chiamata corrispondente al metodo SerCxProgressTransmit non è ancora stata eseguita).

Osservazioni

Il driver del controller seriale chiama questa funzione per ottenere un MDL da usare per l'operazione di trasmissione corrente (scrittura). MDL descrive la memoria del buffer da cui il driver deve ottenere i dati da trasmettere. Il driver è il proprietario esclusivo di questo MDL fino a quando non chiama il metodo SerCxProgressTransmit, dopo il quale il puntatore MDL non è valido e il driver non deve più tentare di accedere al MDL o alla memoria del buffer descritta da MDL.

Per altre informazioni sugli mdls, vedere Using MDLs.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	sercx.h
IRQL	<= DISPATCH_LEVEL

Vedere anche

SerCxProgressTransmit