SerCxRetrieveTransmitMdl 함수(sercx.h)

SerCxRetrieveTransmitMdl 메서드는 전송할 출력 데이터의 다음 블록을 포함하는 버퍼를 설명하는 MDL을 검색합니다.

구문

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

매개 변수

[in] Device

직렬 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 WDFDEVICE 핸들입니다.

[out] Mdl

메서드가 MDL에 대한 포인터를 쓰는 위치에 대한 포인터입니다.

반환 값

SerCxRetrieveTransmitMdl 은 호출이 성공하면 STATUS_SUCCESS 반환합니다. 가능한 반환 값에는 다음 오류 코드가 포함됩니다.

반환 코드	설명
STATUS_INVALID_DEVICE_REQUEST	다음 중 하나가 발생하면 이 값이 반환됩니다. MDL을 가져올 미해결 전송 요청이 없습니다. 전송되는 현재 바이트 수( SerCxProgressTransmit 메서드에서 보고됨)는 0이 아닙니다. 버퍼가 이미 검색되었습니다( SerCxProgressTransmit 메서드에 대한 해당 호출이 아직 발생하지 않음). MDL이 이미 검색되었습니다( SerCxProgressTransmit 메서드에 대한 해당 호출이 아직 발생하지 않음).

설명

직렬 컨트롤러 드라이버는 이 함수를 호출하여 현재 전송(쓰기) 작업에 사용할 MDL을 가져옵니다. MDL은 드라이버가 전송할 데이터를 가져오는 버퍼 메모리를 설명합니다. 드라이버는 SerCxProgressTransmit 메서드를 호출할 때까지 이 MDL의 단독 소유자이며, 그 후에는 MDL 포인터가 유효하지 않으며 드라이버가 MDL 또는 MDL에서 설명하는 버퍼 메모리에 더 이상 액세스하려고 시도하지 않아야 합니다.

MDL에 대한 자세한 내용은 MDL 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	sercx.h
IRQL	<= DISPATCH_LEVEL

추가 정보

SerCxProgressTransmit