WDF_DEVICE_IO_BUFFER_RETRIEVAL 열거형(wudfddi_types.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

WDF_DEVICE_IO_BUFFER_RETRIEVAL 열거형은 UMDF가 드라이버에서 I/O 요청의 버퍼를 사용할 수 있는 시기를 지정하는 데 사용됩니다.

Syntax

typedef enum _WDF_DEVICE_IO_BUFFER_RETRIEVAL {
  WdfDeviceIoBufferRetrievalInvalid,
  WdfDeviceIoBufferRetrievalCopyImmediately,
  WdfDeviceIoBufferRetrievalDeferred,
  WdfDeviceIoBufferRetrievalMaximum
} WDF_DEVICE_IO_BUFFER_RETRIEVAL, *PWDF_DEVICE_IO_BUFFER_RETRIEVAL;

상수

 
WdfDeviceIoBufferRetrievalInvalid
시스템에서 사용하도록 예약되었습니다.
WdfDeviceIoBufferRetrievalCopyImmediately
UMDF는 UMDF가 I/O 요청을 수신하는 즉시 드라이버에서 I/O 요청의 버퍼를 사용할 수 있도록 합니다( UMDF 드라이버 호스트 프로세스에 복사). 자세한 내용은 아래 설명 부분을 참조하십시오.
WdfDeviceIoBufferRetrievalDeferred
UMDF는 드라이버가 버퍼에 액세스하려고 할 때만 I/O 요청의 버퍼를 UMDF 드라이버 호스트 프로세스에 복사하여 드라이버에서 사용할 수 있도록 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
WdfDeviceIoBufferRetrievalMaximum
시스템에서 사용하도록 예약되었습니다.

설명

WDF_DEVICE_IO_BUFFER_RETRIEVAL 열거형은 IWDFDeviceInitialize2::SetIoTypePreference에 대한 입력으로 사용됩니다.

버전 1.9 이전의 UMDF 버전에서 UMDF는 UMDF가 I/O 요청을 수신하는 즉시 항상 드라이버에서 I/O 요청의 버퍼를 사용할 수 있도록 합니다(버퍼를 UMDF 드라이버 호스트 프로세스에 복사). IWDFIoRequest::GetInputMemory 및 IWDFIoRequest::GetOutputMemory 는 드라이버가 버퍼에 액세스하기 위해 호출할 수 있는 유일한 개체 메서드입니다.

UMDF 버전 1.9 이상은 요청 버퍼의 즉시 또는 지연된 검색을 지원할 수 있습니다. 모든 새 드라이버는 일반적으로 즉각적인 검색보다 더 나은 드라이버 성능을 제공하기 때문에 지연된 검색을 사용하도록 설정해야 합니다. 드라이버가 지연된 검색을 사용하도록 설정하지 않으면 UMDF는 즉시 검색을 사용합니다.

버퍼 검색을 연기하려면 드라이버가 IWDFDeviceInitialize2::SetIoTypePreference 를 호출하고 WdfDeviceIoBufferRetrievalDeferred 값을 지정해야 합니다. 드라이버가 지연된 검색을 사용하도록 설정한 후 버퍼링된 또는 직접 액세스 방법을 사용하여 다음 메서드를 호출하여 요청 버퍼에 액세스할 수 있습니다.

IWDFIoRequest2::RetrieveInputBuffer

IWDFIoRequest2::RetrieveInputMemory

IWDFIoRequest2::RetrieveOutputBuffer

IWDFIoRequest2::RetrieveOutputMemory

지연된 검색을 사용하도록 설정하는 드라이버는 IWDFIoRequest::GetInputMemory 및 IWDFIoRequest::GetOutputMemory 를 사용하여 버퍼에 액세스할 수 없습니다.

I/O 요청의 데이터 버퍼에 액세스하는 방법에 대한 자세한 내용은 UMDF-Based 드라이버에서 데이터 버퍼 액세스를 참조하세요.

요구 사항

요구 사항 값
최소 UMDF 버전 1.9
머리글 wudfddi_types.h(Wudfddi.h 포함)

추가 정보

WDF_DEVICE_IO_TYPE(UMDF)