다음을 통해 공유

SerCxRetrieveReceiveMdl 함수(sercx.h)

  • 아티클

SerCxRetrieveReceiveMdl 메서드는 입력 데이터의 다음 블록을 수신하는 데 사용할 버퍼를 설명하는 MDL을 검색합니다.

통사론

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

매개 변수

[in] Device

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

[out] Mdl

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

반환 값

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

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

발언

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

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

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 8부터 사용할 수 있습니다.
대상 플랫폼 보편적
헤더 sercx.h
IRQL <= DISPATCH_LEVEL

참고 항목

SerCxProgressReceive