WdfMemoryCreateFromLookaside 함수(wdfmemory.h)

  • 아티클

[KMDF에만 적용]

WdfMemoryCreateFromLookaside 메서드는 프레임워크 메모리 개체를 만들고 지정된 lookaside 목록에서 메모리 버퍼를 가져옵니다.

구문

NTSTATUS WdfMemoryCreateFromLookaside(
  [in]  WDFLOOKASIDE Lookaside,
  [out] WDFMEMORY    *Memory
);

매개 변수

[in] Lookaside

WdfLookasideListCreate를 호출하여 가져온 프레임워크 lookaside-list 개체에 대한 핸들입니다.

[out] Memory

새 프레임워크 메모리 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다.

반환 값

WdfMemoryCreateFromLookaside 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환합니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 잘못된 매개 변수가 감지되었습니다.
STATUS_INSUFFICIENT_RESOURCES
 메모리가 부족했습니다.
 

이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

드라이버가 WdfLookasideListCreate 를 호출하여 lookaside-list 개체를 만든 후 드라이버는 WdfMemoryCreateFromLookaside 를 호출하여 lookaside 목록에서 버퍼를 가져올 수 있습니다.

프레임워크는 버퍼를 나타내는 메모리 개체에 대한 핸들을 제공합니다. 프레임워크는 메모리 개체를 만들 때 드라이버가 WdfMemoryCreateFromLookaside를 호출할 때 제공한 개체 특성을 사용합니다.

드라이버가 lookaside 목록에서 가져온 메모리 개체 사용을 완료한 경우 드라이버는 WdfObjectDelete 를 호출하여 메모리 개체를 lookaside 목록으로 반환해야 합니다.

프레임워크 메모리 개체 및 lookaside 목록에 대한 자세한 내용은 메모리 버퍼 사용을 참조하세요.

페이징 가능한 메모리 풀에서 lookaside-list 버퍼를 할당하는 경우 IRQL <= APC_LEVEL WdfMemoryCreateFromLookaside 메서드를 호출해야 합니다. 그렇지 않으면 IRQL <= DISPATCH_LEVEL 메서드를 호출할 수 있습니다.

예제

다음 코드 예제에서는 lookaside 목록을 만들고 드라이버 정의 디바이스 개체 컨텍스트 공간에 목록의 핸들을 저장합니다. 그런 다음 드라이버는 lookaside 목록에서 버퍼를 가져옵니다.

PDRIVER_CONTEXT  driverContext;
WDFMEMORY  memHandle;

driverContext = GetDriverContext(driver);

status = WdfLookasideListCreate(
                                WDF_NO_OBJECT_ATTRIBUTES,
                                sizeof(MY_LOOKASIDE_BUFFER),
                                NonPagedPool,
                                WDF_NO_OBJECT_ATTRIBUTES,
                                MY_POOL_TAG,
                                &driverContext->LookasideListHandle
                                );
...
status = WdfMemoryCreateFromLookaside(
                                      driverContext->LookasideListHandle,
                                      &memHandle
                                      );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfmemory.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL 설명 섹션을 참조하십시오.
DDI 규정 준수 규칙 DriverCreate(kmdf)

추가 정보

WdfLookasideListCreate

WdfMemoryCreate

WdfMemoryCreatePreallocated

WdfObjectDelete